Sigmap Vscode

SigMap — VS Code Extension

Zero-dependency AI context engine for VS Code, Cursor, and VSCodium

[](https://marketplace.visualstudio.com/items?itemName=manojmallick.sigmap) [](https://open-vsx.org/extension/manojmallick/sigmap) [](https://marketplace.visualstudio.com/items?itemName=manojmallick.sigmap) [](https://marketplace.visualstudio.com/items?itemName=manojmallick.sigmap) [](https://github.com/manojmallick/sigmap-vscode/releases) [](LICENSE) [](https://nodejs.org)

80.0% retrieval hit@5 · 96.9% token reduction · 29 languages · Zero npm deps

---

What is SigMap?

SigMap extracts a compact signature map of your entire codebase — function names, class hierarchies, exported types, interfaces — and writes it to .github/copilot-instructions.md automatically.

Every AI coding assistant (GitHub Copilot, Claude, Cursor, Windsurf, Gemini, Codex) reads that file as its first-message context. Without it, the AI starts knowing nothing about your project. With SigMap, it starts with everything.

Before SigMap: "I don't know your codebase — can you share some files?"
After SigMap:  "I can see your AuthService, UserRepository, 47 API routes…"

A 50,000-line TypeScript monorepo → ~3,800 tokens of pure signatures — 96.9% reduction.

---

What's new in v4.0

• Standalone release — independent version cycle from the SigMap CLI core
• Compatible with SigMap CLI v6.0: graph-boosted retrieval (83.3% hit@5), incremental sig cache
• 29 languages (up from 25 in v2.x)
• Corrected canonical benchmark numbers (96.9% token reduction, 80.0% hit@5)

---

Features

Live health grade in the status bar

| Grade | Status bar | Meaning | |:---:|---|---| | A | sm: ✔ A 2h ago | Fresh — AI has full context | | B | sm: ℹ B 6h ago | Good | | C | sm: ⚠ C 1d ago | Stale — regenerate soon | | D | sm: ✖ D 3d ago | Very stale — regenerate now |

Click the status bar item for instant regeneration.

Other features

• Auto-regeneration — checks on startup and every 60 seconds
• Stale notifications — pop-up with one-click Regenerate after 24 h
• Secret scanning — AWS keys, tokens, DB strings auto-redacted before writing
• MCP server — 9 tools exposed over stdio JSON-RPC for Claude / Cursor
• One-command context — SigMap: Regenerate Context from the Command Palette

---

Installation

VS Code Marketplace (recommended)

Search "SigMap" in the Extensions panel, or:

ext install manojmallick.sigmap

Open VSX (VSCodium / Gitpod / Windsurf)

open-vsx.org/extension/manojmallick/sigmap

Manual (.vsix)

Download sigmap-X.Y.Z.vsix from Releases, then:

Extensions: Install from VSIX…

---

Quick start

# 1. Install the CLI
npm install -g sigmap

# 2. In VS Code: Ctrl+Shift+P → SigMap: Regenerate Context
# Or run directly:
npx sigmap

Then use the full workflow:

sigmap ask "where is auth handled?"   # query-focused context
sigmap validate                        # check coverage
sigmap judge                           # score answer groundedness
sigmap --watch                         # auto-regenerate on save

---

Requirements

| Requirement | Details | |---|---| | VS Code | 1.85.0 or higher | | Node.js | 18 or higher | | SigMap CLI | npm install -g sigmap · npm install sigmap · npx sigmap · or standalone binary |

---

29 Language support

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

---

Commands

| Command | Description | |---|---| | SigMap: Regenerate Context | Run sigmap in your workspace root | | SigMap: Open Context File | Open .github/copilot-instructions.md |

CLI reference

sigmap                    # generate once
sigmap ask ""      # ranked context for a specific task
sigmap validate           # check coverage health
sigmap judge              # groundedness score for an AI answer
sigmap --watch            # auto-regenerate on file changes
sigmap --health           # 0–100 health score
sigmap --mcp              # start MCP server (9 tools)
sigmap --diff             # context for changed files only

---

MCP server (9 tools)

Works with Claude Code and Cursor via sigmap --mcp:

| Tool | Description | |---|---| | read_context | Full or per-module signature map | | search_signatures | Keyword search across all signatures | | get_map | Import graph, class hierarchy, or route table | | query_context | Graph-boosted ranked file retrieval | | create_checkpoint | Session checkpoint with git state | | get_routing | Model routing hints (fast/balanced/powerful) | | explain_file | Signatures, imports, and callers for a file | | list_modules | All modules sorted by token count | | get_impact | Blast-radius BFS for a changed file |

---

Benchmark

| Metric | Value | |---|---:| | Retrieval hit@5 | 80.0% vs 13.6% baseline | | Graph-boosted hit@5 | 83.3% | | Overall token reduction | 96.9% | | Prompt reduction | 40.8% (2.84 → 1.68 prompts) | | Task success proxy | 52.2% | | GPT-4o overflow repos | 13/18 → 0/18 | | Languages | 29 |

Benchmark ID: sigmap-v6.0-main · Date: 2026-04-19

---

Token reduction by repo

| Repo | Language | Reduction | |---|---|---:| | express | JavaScript | 98.7% | | flask | Python | 96.0% | | gin | Go | 96.7% | | spring-petclinic | Java | 99.2% | | rails | Ruby | 99.5% | | rust-analyzer | Rust | 99.8% | | abseil-cpp | C++ | 99.7% | | laravel | PHP | 99.6% | | vue-core | Vue | 97.8% |

---

Settings

| Setting | Default | Description | |---|---|---| | sigmap.scriptPath | "" | Absolute path to gen-context.js. Leave empty to auto-detect. |

---

Troubleshooting

Status bar shows sm: no context → Run SigMap: Regenerate Context. Check Node 18+: node --version

"command not found" → npm install -g sigmap or set sigmap.scriptPath in settings

Copilot not using the context → File must be at .github/copilot-instructions.md in the workspace root

Want to exclude files? → Create .contextignore (gitignore syntax) in your project root

---

AI tool integration

| Tool | How | |---|---| | GitHub Copilot | Reads .github/copilot-instructions.md automatically | | Claude / Claude Code | Add "outputs": ["claude"] to config → writes CLAUDE.md | | Cursor | Add "outputs": ["cursor"] → writes .cursorrules | | Windsurf | Add "outputs": ["windsurf"] → writes .windsurfrules | | MCP (Claude/Cursor) | sigmap --mcp — 9 tools over stdio JSON-RPC |

---

Links

| | | |---|---| | 📖 Docs | manojmallick.github.io/sigmap | | 🔌 JetBrains plugin | github.com/manojmallick/sigmap-jetbrains | | 🖥 CLI / core | github.com/manojmallick/sigmap | | 📦 npm | npmjs.com/package/sigmap | | 🟣 Open VSX | open-vsx.org/extension/manojmallick/sigmap | | 🐛 Issues | github.com/manojmallick/sigmap-vscode/issues |

---

MIT © 2026 Manoj Mallick · Made in Amsterdam 🇳🇱

SigMap for daily always-on context · Repomix for deep one-off sessions — use both.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: manojmallick
• Source: manojmallick/sigmap-vscode
• License: MIT
• Homepage: https://sigmap.io

Install and usage instructions live in the source repository linked above.