-
Notifications
You must be signed in to change notification settings - Fork 37
FAQ General
SigMap is a code context engine for AI coding sessions. It:
- Extracts code signatures (functions, classes, exports) from your project
- Retrieves relevant files based on your query
- Validates context coverage
- Scores how grounded AI answers are in your code
Key stats: 97.9% average token reduction, 78.9% hit@5 retrieval accuracy, 31 languages.
| Feature | SigMap | Repomix | RAG | Embeddings |
|---|---|---|---|---|
| No npm install | ✓ | ✗ | ✗ | ✗ |
| Zero dependencies | ✓ | ✗ | ✗ | ✗ |
| Local & offline | ✓ | ✓ | ✗ | ✗ |
| Query-specific context | ✓ | ✗ | ✓ | ✓ |
| Validates coverage | ✓ | ✗ | ✗ | Partial |
| Scores groundedness | ✓ | ✗ | ✗ | ✗ |
Officially supported:
- Claude Code / Cursor (MCP)
- Copilot / Windsurf (MCP)
- Codex / Gemini CLI (direct)
- OpenCode / Aider / Cline (file injection)
Can use manually:
- Any IDE (copy/paste
.context/query-context.md)
See MCP Setup Guide.
Free. MIT open source, zero API costs, runs locally.
Yes. After sigmap generates the context file, everything runs offline.
31 languages: JavaScript, TypeScript, Python, Go, Rust, Java, Kotlin, Ruby, PHP, Swift, C#, C++, Dart, Scala, Vue, Svelte, GraphQL, SQL, Terraform, Bash, Shell, Dockerfile, Makefile, JSON, YAML, TOML, XML, Markdown, R, and GDScript.
See Language Support.
Yes. Three modes:
- Global — One context for entire monorepo
- Per-package — Separate context per workspace
- Scoped — Infer package from query tokens
See Monorepo Setup.
Create .contextignore in project root (gitignore syntax):
node_modules/
dist/
build/
*.test.js
*.spec.ts
coverage/
See Configuration Guide.
Yes. Two strategies:
- Fail on budget — Enforce max tokens
- Comment on PRs — Post reduction metrics
See CI/CD Integration.
- ask — Retrieves top files for a query (fast, specific)
- validate — Checks if all needed files are in context (comprehensive)
Use together:
sigmap ask "auth login"
sigmap validate --query "auth login"Yes. Create custom extractors for:
- Domain-specific languages (DSLs)
- Framework-specific patterns
- Proprietary syntax
See Custom Extractors.
MCP (Model Context Protocol) tools let you:
- Query context dynamically from Claude Code
- Explain any file with imports/exports
- Get impact blast radius
- Search signatures
See MCP Extensions.
sigmap learn tracks which files helped with each task:
sigmap learn --task "fix auth bug" --helpful src/auth.js src/sessions.jsThis boosts scores for files that solve similar tasks.
See Learning Guide.
Yes. SigMap works with:
- Cloud: Claude, GPT-4, Gemini
- Open-source: Llama, Mistral, Code Llama
- Local: Ollama, llama.cpp, vLLM
See Local LLMs Guide.