sigmap

README

⚡ SigMap

SigMap finds the right files before your AI answers.

---

Try it now

No install required. Run instantly on any machine:

npx sigmap
npx sigmap ask "Where is auth handled?"

Zero config. Zero dependencies. Under 10 seconds.

---

What is SigMap?

SigMap extracts function and class signatures from your codebase and feeds the right files — not the whole repo — to your AI.

Model-agnostic. Works with:

• Cloud LLMs: Claude, GPT-4, Copilot, Gemini
• Open-source agents: OpenCode, Aider, OpenHands, Cline
• Local LLMs: Ollama, llama.cpp, vLLM (no API keys, full privacy)
• Any editor: VS Code, Cursor, Windsurf, Neovim, JetBrains
• Any model: Use what you want, no vendor lock-in

---

Why SigMap?

• 80.0% hit@5 — right file found in top 5 results (vs 13.6% baseline)
• 40–98% token reduction — 2K–4K tokens instead of 80K+
• 52.2% task success rate — up from 10% without context
• 1.68 prompts per task — down from 2.84
• No vendor lock-in — works with any AI assistant or local LLM
• No API costs — use local models (Ollama, llama.cpp, vLLM) with zero token fees
• Full privacy — keep your code and context on your machine
• Zero npm dependencies — npx sigmap on any machine

---

Replace this with SigMap

Without SigMap	With SigMap
❌ Guessing which files are relevant	✅ Right file in context — 80% of the time
❌ Sending the full repo to your AI	✅ Minimal context — only what matters
❌ Embeddings / vector DB required	✅ Grounded answers, no infra needed

---

How it works

Ask → Rank → Context → Validate → Judge → Learn

1. Ask — sigmap ask "Where is auth handled?" — ranked file list
2. Rank — TF-IDF scores every file against your query
3. Context — writes compact signatures to your AI's context file
4. Validate — sigmap validate — confirms right files are in scope
5. Judge — sigmap judge — scores answer groundedness against context
6. Learn — sigmap weights — boosts files that keep solving your tasks

---

Benchmark

Benchmark : sigmap-v6.10-main
Date      : 2026-05-12

Hit@5          : 80.0%   (baseline 13.6%  — 5.9× lift)
Prompt reduction : 41.4%
Task success   : 52.2%   (baseline 10%)
Prompts / task : 1.68    (baseline 2.84)
Token reduction: 40–98%  (avg 96.8% across 18 real repos)

Measured on 90 coding tasks across 18 real public repos. No LLM API — fully reproducible.

Resources:

• Full methodology →
• Benchmark suite (GitHub) — scripts, tasks, and raw data
• Benchmark data (Zenodo) — archived results for reproducibility

---

Install

Try without installing:

npx sigmap

Install globally:

npm install -g sigmap

Install per-project:

npm install --save-dev sigmap

Standalone binary — no Node.js required:

Platform	Download
macOS Apple Silicon	sigmap-darwin-arm64
macOS Intel	sigmap-darwin-x64
Linux x64	sigmap-linux-x64
Windows x64	sigmap-win32-x64.exe

Each binary ships with a .sha256 checksum. Verify a binary →

Volta:

volta install sigmap

---

Integrations

AI assistants — one run, all of them:

Adapter	Output file	Used by
copilot	.github/copilot-instructions.md	GitHub Copilot, OpenCode
claude	CLAUDE.md	Claude / Claude Code
cursor	.cursorrules	Cursor, Cline
windsurf	.windsurfrules	Windsurf
openai	.github/openai-context.md	OpenAI API, Aider, local Ollama/llama.cpp
gemini	.github/gemini-context.md	Google Gemini
codex	AGENTS.md	OpenAI Codex (legacy)

sigmap --adapter copilot   # default — works with Copilot, OpenCode
sigmap --adapter openai    # works with Ollama, llama.cpp, vLLM, Aider
sigmap --adapter claude    # works with Claude Code

Open-source agents & local LLMs:

Use SigMap with open-source tools and fully self-hosted setups:

• Open-source agents guide → — OpenCode, Aider, OpenHands, Cline
• Local LLMs guide → — Ollama, llama.cpp, vLLM (no API keys, full privacy)

IDE extensions:

IDE	Install	Source	Features
VS Code	Marketplace · Open VSX	github.com/manojmallick/sigmap-vscode	Status bar health grade, stale context alerts, one-click regen
JetBrains	Marketplace	github.com/manojmallick/sigmap-jetbrains	IntelliJ IDEA, WebStorm, PyCharm, GoLand — tool window + actions
Neovim	lazy.nvim / packer / vim-plug	github.com/manojmallick/sigmap.nvim	:SigMap, :SigMapQuery float window, statusline widget

MCP server — 9 on-demand tools for Claude Code and Cursor:

sigmap --mcp

---

Try it

# 1. Generate context for your project
npx sigmap

# 2. Ask a question — get ranked files
sigmap ask "Where is auth handled?"

# 3. Validate — confirm the right files are in scope
sigmap validate --query "auth login token"

# 4. Judge — score your AI's answer for groundedness
sigmap judge --response response.txt --context .context/query-context.md

# 5. Inspect health
sigmap --health

---

Start guide

Who	Start here
👶 New	Quick start guide — setup in 60 seconds
⚡ Daily	sigmap ask / sigmap validate / sigmap judge
🧠 Advanced	Context strategies · MCP setup
🏢 Teams	Config reference · CI setup

---

Docs

manojmallick.github.io/sigmap

Section	Link
CLI reference (32 commands)	cli.html
Benchmark methodology	benchmark.html
Config reference	config.html
Roadmap	roadmap.html
29 languages	generalization.html

---

Support

If SigMap saves you context or API spend, a ⭐ on GitHub helps others find it.

Report an issue · Changelog

---

Contributing

SigMap welcomes contributions!

Before submitting a PR:

1. Read CONTRIBUTING.md
2. Check Discussions → Announcements for workflow setup
3. Target the develop branch (not main)
4. Follow the contributor checklist

See .github/PULL_REQUEST_TEMPLATE.md for the PR checklist. All contributors are credited in the CHANGELOG and release notes.

---

Why not embeddings?

	Embeddings	SigMap
Vector DB required	✅	❌
Infrastructure to run	✅	❌
Drift over time	✅	❌
Deterministic results	❌	✅
Zero-config setup	❌	✅
Works offline	❌	✅

• No vector DB — signatures are plain text files committed to your repo
• No infra — runs locally, zero cloud dependencies
• No drift — regenerating is npx sigmap, not a reindex pipeline
• Deterministic — same input always produces same ranked output
• Faster — TF-IDF ranking runs in milliseconds, no embeddings to compute

---

29 languages

TypeScript · JavaScript · Python · Java · Kotlin · Go · Rust · C# · C/C++ · Ruby · PHP · Swift · Dart · Scala · Vue · Svelte · HTML · CSS/SCSS · YAML · Shell · SQL · GraphQL · Terraform · Protobuf · Dockerfile · TOML · XML · Properties · Markdown

All implemented with zero external dependencies.

Full language table →

---

License

MIT © 2026 Manoj Mallick · Made in Amsterdam

---

Docs · Changelog · Roadmap · npm

⭐ Star on GitHub if SigMap saves you tokens.