Skip to content

quick-context-setup.md

Latest commit

 

History

History
115 lines (92 loc) · 3.27 KB

quick-context-setup.md

File metadata and controls

115 lines (92 loc) · 3.27 KB
Raw

Quick Context Setup for Claude Code Sessions

🎯 Fastest Way to Get Full Context

Option 1: Natural Language Setup (No Configuration Required!)

Start your Claude Code session with this approach - no configuration needed:

"Get the current working directory with pwd, export MCP_CLIENT_CWD to that value, then run a health check to verify the correct project context"

Or for indexing:

"First run pwd and export MCP_CLIENT_CWD=$(pwd), then reindex this directory and give me an overview of the project structure"

This natural language approach:

  • Works immediately without any configuration changes
  • Ensures the MCP server knows your actual working directory
  • Can be used in any project without setup

Option 2: One-Line Reindex

If you're already in the correct directory:

"Reindex this directory, then search for the main files and give me an overview of the project structure"

This will:

  1. Clear any stale data
  2. Index all current files
  3. Search and summarize key components
  4. Give you a project overview

Option 3: Auto-Index on Start

Add to your shell config (~/.bashrc or ~/.zshrc):

# Auto-index every Claude session
export QDRANT_RAG_AUTO_INDEX=true
alias claude-dev='QDRANT_RAG_AUTO_INDEX=true claude'

Option 4: Use the Session Starter

# From any project directory
~/path/to/qdrant-rag/scripts/start-session.sh

📋 Essential First Commands

After starting Claude Code, use these commands for instant context:

  1. Set Working Directory + Health Check (Recommended first command):

    "Run pwd to get current directory, export MCP_CLIENT_CWD=$(pwd), then run a health check to confirm project context"

  2. Full Reindex + Overview:

    "Export MCP_CLIENT_CWD=$(pwd), then reindex the current directory and tell me about the project structure, main files, and recent changes"

  3. Quick Context Verification:

    "Run a health check and show me the current project context"

  4. Find Key Files:

    "Search for README, main, index, app, and config files to understand the project"

  5. Understand Dependencies:

    "Search for package.json, requirements.txt, pyproject.toml, or go.mod and summarize the dependencies"

🚀 Pro Tips

Create a Project-Specific Alias

Add to your project's README or documentation:

# Quick start for this project
alias claude-this='cd /path/to/project && QDRANT_RAG_AUTO_INDEX=true claude'

Use Directory-Specific Environment

Create .envrc in your project (using direnv):

# .envrc
export QDRANT_RAG_AUTO_INDEX=true
export QDRANT_RAG_DEBOUNCE=2.0

Combine with Git

Start with recent changes context:

"Reindex this directory, then search for files modified in the last week and summarize recent changes"

🎪 Advanced Context Loading

For large projects, index strategically:

"First index just the src directory, then search for the main entry points"
"Index all Python files and search for class definitions"
"Index configuration files and tell me about the project setup"

💡 Context Verification

Always verify your context is loaded:

"What files are currently indexed for this project?"
"Show me the health check status"
"Search for a known file to verify indexing worked"