convez.ai
MCP Server
manojmallick

sigmap

manojmallick/sigmap

Ver no GitHub
Muito bomPluginScore · de 0 a 100

97% token reduction for AI coding sessions — zero deps, 31 languages, MCP server

Instalação

$npx convez-ai manojmallick/sigmap

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
652
Forks
52
Acompanhando
3
Saúde
100%
Último commit
há 1 dia
Versão
v8.87.0
Issues abertas
55
Contribuidores
7

README

A tradução para o português deste README ainda está na fila.

⚡ SigMap

SigMap finds the right files before your AI answers.

npm version npm downloads CI Zero deps License: MIT GitHub Stars Star History Chart Discover on ShyPD


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?

  • 75.6% hit@5 — right file found in top 5 results (vs 13.6% baseline)
  • 97.0% token reduction — average across 21 real repos
  • 52.2% task success rate — up from 10% without context
  • 1.72 prompts per task — down from 2.84 (39.4% fewer retries)
  • 31 languages supported — TypeScript, Python, Go, Rust, Java, R, and 25 others
  • 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 SigMapWith SigMap
❌ Guessing which files are relevant✅ Right file in context — 76% 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-v7.0-main (21 repositories, including R language)
Date      : 2026-06-14

Hit@5          : 75.6%   (baseline 13.6%  — 5.6× lift)
Token reduction: 97.0%   (across 21 repos)
Prompt reduction : 39.4% (2.84 → 1.72 prompts per task)
Task success   : 52.2%   (baseline 10%)
Repos tested   : 21 (JavaScript, Python, Go, Rust, Java, R, C++, C#, Dart, Swift, Ruby, PHP, Scala, Kotlin, and more)

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

Resources:


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:

PlatformDownload
macOS Apple Siliconsigmap-darwin-arm64
macOS Intelsigmap-darwin-x64
Linux x64sigmap-linux-x64
Windows x64sigmap-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:

AdapterOutput fileUsed by
copilot.github/copilot-instructions.mdGitHub Copilot, OpenCode
claudeCLAUDE.mdClaude / Claude Code
cursor.cursorrulesCursor, Cline
windsurf.windsurfrulesWindsurf
openai.github/openai-context.mdOpenAI API, Aider, local Ollama/llama.cpp
gemini.github/gemini-context.mdGoogle Gemini
codexAGENTS.mdOpenAI 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:

IDE extensions:

IDEInstallSourceFeatures
VS CodeMarketplace · Open VSXgithub.com/manojmallick/sigmap-vscodeStatus bar health grade, stale context alerts, one-click regen
JetBrainsMarketplacegithub.com/manojmallick/sigmap-jetbrainsIntelliJ IDEA, WebStorm, PyCharm, GoLand — tool window + actions
Neovimlazy.nvim / packer / vim-pluggithub.com/manojmallick/sigmap.nvim:SigMap, :SigMapQuery float window, statusline widget

MCP server — 10 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

WhoStart here
👶 NewQuick start guide — setup in 60 seconds
⚡ Dailysigmap ask / sigmap validate / sigmap judge
🧠 AdvancedContext strategies · MCP setup
🏢 TeamsConfig reference · CI setup

Docs

sigmap.io

SectionLink
CLI reference (32 commands)cli.html
Benchmark methodologybenchmark.html
Config referenceconfig.html
Roadmaproadmap.html
31 languagesgeneralization.html

Support

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

Report an issue · Changelog


Sponsor

SigMap is built and maintained by one developer, kept zero-dependency, offline, and free. If it saves your team context or API spend, sponsoring keeps it that way — and funds the benchmark CI, the sigmap.io domain, and ongoing supply-chain hardening.

💜 Become a sponsor → · see SPONSOR.md for tiers and exactly where your support goes. Any amount helps — even $1/mo — and a ⭐ or a share counts too.


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?

EmbeddingsSigMap
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

31 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 · R · GDScript

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.

Ver o original no GitHub

Bom para

Relacionados