IDE Setup

IDE Setup

Claude Code / Cursor (Recommended)

Via MCP (Best)

1. Update your claude_desktop_config.json:

   macOS/Linux: ~/.claude/claude_desktop_config.json
   Windows: %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "sigmap": {
         "command": "node",
         "args": ["/path/to/sigmap/gen-context.js", "--mcp"],
         "cwd": "/path/to/your/project"
       }
     }
   }

2. Restart Claude Code

3. Use MCP tools in chat:

   • explain_file — Show imports/exports/callers
   • search_signatures — Find symbols across codebase
   • query_context — Get dynamic context for your question
   • list_modules — Browse all indexed files

Via File Injection

Copy context file to project:

sigmap ask "your query"
# Manually attach .context/query-context.md in Claude Code

---

Copilot / GitHub Copilot Chat

Step 1: Generate Context

cd your-project
sigmap ask "feature you're working on"

Step 2: Create System Prompt

Create .github/copilot-instructions.md:

# Code Context

Use the attached code signatures to understand the codebase:

{{insert .context/context.md here}}

Step 3: Reference in Chat

@instructions help me implement login feature

Copilot uses the context to provide better suggestions.

---

Windsurf

Same as Cursor. Update claude_desktop_config.json with MCP server config.

---

OpenCode / Aider / Cline

Step 1: Generate Context

sigmap

Step 2: File Injection

Point to context file when starting:

aider --read-only .context/context.md

Or copy contents to agent's context manually.

Step 3: Keep Updated

Regenerate when context stales:

sigmap --watch

---

Local LLMs (Ollama, llama.cpp, vLLM)

Step 1: Install Local Model

# Ollama example
ollama pull mistral
ollama serve

Step 2: Generate SigMap Context

sigmap ask "your query"

Step 3: Inject into Local LLM

# Using ollama CLI
cat .context/query-context.md | ollama run mistral

Or use an API:

curl http://localhost:11434/api/generate \
  -d '{
    "model": "mistral",
    "prompt": "Context file content here...",
    "stream": false
  }'

---

VS Code Extension

No native SigMap extension yet, but you can:

1. Use REST Client + MCP
2. Copy .context/query-context.md to editor
3. Use terminal to run sigmap ask

---

JetBrains IDEs (IntelliJ, PyCharm, etc.)

Option 1: Terminal Integration

# In IDE terminal
sigmap ask "question"
# Copy output to editor

Option 2: External Tools

Add custom tool in IDE settings:

Name: SigMap Query
Program: sigmap
Arguments: ask "$SELECTED_TEXT$"
Working directory: $ProjectFileDir$

Then: Right-click → External Tools → SigMap Query

---

Vim / Neovim

Generate context once, then reference:

sigmap
# Open in split
:vsplit .context/query-context.md

Or use as pre-prompt for external LLM:

" .vimrc / init.vim
nnoremap <leader>sc :!sigmap ask<Space>

---

Best Practices

1. Regenerate on major changes

   sigmap --watch  # Auto-regenerate

2. Use specific queries

   • ✓ "auth flow for login"
   • ✗ "code"

3. Validate coverage

   sigmap validate --query "your question"

4. Score answers

   sigmap judge --response answer.txt --context .context/query-context.md

---

Troubleshooting

MCP Tools Not Appearing

Check config file syntax:

cat ~/.claude/claude_desktop_config.json

Restart Claude Code completely.

Context Not Updating

rm .context/context.md
sigmap  # Regenerate

"File not found" Errors

Ensure cwd in config points to project root where gen-context.config.json lives.

---

Next Steps

• First Context Generation
• FAQ
• MCP Setup Guide