{"id":47770687,"url":"https://github.com/manojmallick/sigmap","last_synced_at":"2026-05-10T15:18:37.536Z","repository":{"id":348373366,"uuid":"1197711007","full_name":"manojmallick/sigmap","owner":"manojmallick","description":"97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server","archived":false,"fork":false,"pushed_at":"2026-04-14T21:39:49.000Z","size":48661,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-14T22:28:57.208Z","etag":null,"topics":["ai","claude","code-context","cursor","github-copilot","llm","mcp","nodejs","token-reduction","zero-dependencies"],"latest_commit_sha":null,"homepage":"https://manojmallick.github.io/sigmap/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manojmallick.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.html","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-31T20:17:51.000Z","updated_at":"2026-04-14T21:39:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"60e5e885-9b55-42bb-8df3-c5bc6d089560","html_url":"https://github.com/manojmallick/sigmap","commit_stats":null,"previous_names":["manojmallick/context-forge","manojmallick/sigmap"],"tags_count":69,"template":false,"template_full_name":null,"purl":"pkg:github/manojmallick/sigmap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojmallick%2Fsigmap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojmallick%2Fsigmap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojmallick%2Fsigmap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojmallick%2Fsigmap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manojmallick","download_url":"https://codeload.github.com/manojmallick/sigmap/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojmallick%2Fsigmap/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32031073,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude","code-context","cursor","github-copilot","llm","mcp","nodejs","token-reduction","zero-dependencies"],"created_at":"2026-04-03T09:05:19.340Z","updated_at":"2026-05-10T15:18:37.507Z","avatar_url":"https://github.com/manojmallick.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"assets/logo.png\" alt=\"SigMap logo\" width=\"80\" height=\"80\" /\u003e\n\n# ⚡ SigMap\n\n**SigMap finds the right files before your AI answers.**\n\n[![npm version](https://img.shields.io/npm/v/sigmap?color=7c6af7\u0026label=latest\u0026logo=npm)](https://www.npmjs.com/package/sigmap)\n[![npm downloads](https://img.shields.io/npm/dt/sigmap?color=22c55e\u0026label=downloads\u0026logo=npm)](https://www.npmjs.com/package/sigmap)\n[![CI](https://github.com/manojmallick/sigmap/actions/workflows/ci.yml/badge.svg)](https://github.com/manojmallick/sigmap/actions/workflows/ci.yml)\n[![Zero deps](https://img.shields.io/badge/dependencies-zero-22c55e)](package.json)\n[![License: MIT](https://img.shields.io/badge/License-MIT-7c6af7.svg)](LICENSE)\n[![GitHub Stars](https://img.shields.io/github/stars/manojmallick/sigmap?style=flat\u0026color=f59e0b\u0026logo=github)](https://github.com/manojmallick/sigmap/stargazers)\n[![Star History Chart](https://api.star-history.com/svg?repos=manojmallick/sigmap\u0026type=Date)](https://star-history.com/#manojmallick/sigmap\u0026Date)\n[![Discover on ShyPD](https://img.shields.io/badge/ShyPD-Discover-7c6af7?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDE2IDE2Ij48Y2lyY2xlIGN4PSI4IiBjeT0iOCIgcj0iOCIgZmlsbD0id2hpdGUiLz48L3N2Zz4=\u0026logoColor=7c6af7)](https://shypd.ai/tools/sigmap)\n\n\u003c/div\u003e\n\n---\n\n## Try it now\n\n**No install required.** Run instantly on any machine:\n\n```bash\nnpx sigmap\nnpx sigmap ask \"Where is auth handled?\"\n```\n\nZero config. Zero dependencies. Under 10 seconds.\n\n---\n\n## What is SigMap?\n\nSigMap extracts function and class signatures from your codebase and feeds the right files — not the whole repo — to your AI.\n\nWorks with Copilot, Claude, Cursor, Windsurf, and any LLM.\n\n---\n\n## Why SigMap?\n\n- **80.0% hit@5** — right file found in top 5 results (vs 13.6% baseline)\n- **40–98% token reduction** — 2K–4K tokens instead of 80K+\n- **52.2% task success rate** — up from 10% without context\n- **1.68 prompts per task** — down from 2.84\n- **Works with any LLM** — no API key, no cloud, no accounts\n- **Zero npm dependencies** — `npx sigmap` on any machine\n\n---\n\n## Replace this with SigMap\n\n| Without SigMap | With SigMap |\n|---|---|\n| ❌ Guessing which files are relevant | ✅ Right file in context — 80% of the time |\n| ❌ Sending the full repo to your AI | ✅ Minimal context — only what matters |\n| ❌ Embeddings / vector DB required | ✅ Grounded answers, no infra needed |\n\n---\n\n## How it works\n\n```\nAsk → Rank → Context → Validate → Judge → Learn\n```\n\n1. **Ask** — `sigmap ask \"Where is auth handled?\"` — ranked file list\n2. **Rank** — TF-IDF scores every file against your query\n3. **Context** — writes compact signatures to your AI's context file\n4. **Validate** — `sigmap validate` — confirms right files are in scope\n5. **Judge** — `sigmap judge` — scores answer groundedness against context\n6. **Learn** — `sigmap weights` — boosts files that keep solving your tasks\n\n---\n\n## Benchmark\n\n```\nBenchmark : sigmap-v6.10-main\nDate      : 2026-05-05\n\nHit@5          : 80.0%   (baseline 13.6%  — 5.9× lift)\nPrompt reduction : 41.0%\nTask success   : 52.2%   (baseline 10%)\nPrompts / task : 1.68    (baseline 2.84)\nToken reduction: 40–98%  (avg 96.8% across 18 real repos)\n```\n\nMeasured on 90 coding tasks across 18 real public repos. No LLM API — fully reproducible.\n\n**Resources:**\n- [Full methodology →](https://manojmallick.github.io/sigmap/guide/benchmark.html)\n- [Benchmark suite (GitHub)](https://github.com/manojmallick/sigmap-benchmark-suite) — scripts, tasks, and raw data\n- [Benchmark data (Zenodo)](https://zenodo.org/records/19898842) — archived results for reproducibility\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"docs/comparison-chart.svg\" alt=\"SigMap benchmark — before vs after across 3 RAG quality metrics\" width=\"700\" /\u003e\n\u003c/div\u003e\n\n---\n\n## Install\n\n**Try without installing:**\n\n```bash\nnpx sigmap\n```\n\n**Install globally:**\n\n```bash\nnpm install -g sigmap\n```\n\n**Install per-project:**\n\n```bash\nnpm install --save-dev sigmap\n```\n\n**Standalone binary** — no Node.js required:\n\n| Platform | Download |\n|---|---|\n| macOS Apple Silicon | [`sigmap-darwin-arm64`](https://github.com/manojmallick/sigmap/releases/latest/download/sigmap-darwin-arm64) |\n| macOS Intel | [`sigmap-darwin-x64`](https://github.com/manojmallick/sigmap/releases/latest/download/sigmap-darwin-x64) |\n| Linux x64 | [`sigmap-linux-x64`](https://github.com/manojmallick/sigmap/releases/latest/download/sigmap-linux-x64) |\n| Windows x64 | [`sigmap-win32-x64.exe`](https://github.com/manojmallick/sigmap/releases/latest/download/sigmap-win32-x64.exe) |\n\nEach binary ships with a `.sha256` checksum. [Verify a binary →](docs/readmes/binaries.md)\n\n**Volta:**\n\n```bash\nvolta install sigmap\n```\n\n---\n\n## Integrations\n\n**AI assistants — one run, all of them:**\n\n| Adapter | Output file | Used by |\n|---|---|---|\n| `copilot` | `.github/copilot-instructions.md` | GitHub Copilot |\n| `claude` | `CLAUDE.md` | Claude / Claude Code |\n| `cursor` | `.cursorrules` | Cursor |\n| `windsurf` | `.windsurfrules` | Windsurf |\n| `openai` | `.github/openai-context.md` | OpenAI models |\n| `gemini` | `.github/gemini-context.md` | Google Gemini |\n| `codex` | `AGENTS.md` | OpenAI Codex · OpenCode |\n\n```bash\nsigmap --adapter copilot   # default\nsigmap --adapter claude\nsigmap --adapter cursor\n```\n\n**IDE extensions:**\n\n| IDE | Install | Source | Features |\n|-----|---------|--------|----------|\n| **VS Code** | [Marketplace](https://marketplace.visualstudio.com/items?itemName=manojmallick.sigmap) · [Open VSX](https://open-vsx.org/extension/manojmallick/sigmap) | [github.com/manojmallick/sigmap-vscode](https://github.com/manojmallick/sigmap-vscode) | Status bar health grade, stale context alerts, one-click regen |\n| **JetBrains** | [Marketplace](https://plugins.jetbrains.com/plugin/31109-sigmap--ai-context-engine/) | [github.com/manojmallick/sigmap-jetbrains](https://github.com/manojmallick/sigmap-jetbrains) | IntelliJ IDEA, WebStorm, PyCharm, GoLand — tool window + actions |\n| **Neovim** | lazy.nvim / packer / vim-plug | [github.com/manojmallick/sigmap.nvim](https://github.com/manojmallick/sigmap.nvim) | `:SigMap`, `:SigMapQuery` float window, statusline widget |\n\n**MCP server** — 9 on-demand tools for Claude Code and Cursor:\n\n```bash\nsigmap --mcp\n```\n\n---\n\n## Try it\n\n```bash\n# 1. Generate context for your project\nnpx sigmap\n\n# 2. Ask a question — get ranked files\nsigmap ask \"Where is auth handled?\"\n\n# 3. Validate — confirm the right files are in scope\nsigmap validate --query \"auth login token\"\n\n# 4. Judge — score your AI's answer for groundedness\nsigmap judge --response response.txt --context .context/query-context.md\n\n# 5. Inspect health\nsigmap --health\n```\n\n---\n\n## Start guide\n\n| Who | Start here |\n|---|---|\n| 👶 **New** | [Quick start guide](docs/readmes/GETTING_STARTED.md) — setup in 60 seconds |\n| ⚡ **Daily** | `sigmap ask` / `sigmap validate` / `sigmap judge` |\n| 🧠 **Advanced** | [Context strategies](docs/readmes/CONTEXT_STRATEGIES.md) · [MCP setup](docs/readmes/MCP_SETUP.md) |\n| 🏢 **Teams** | [Config reference](https://manojmallick.github.io/sigmap/guide/config.html) · [CI setup](docs/readmes/ENTERPRISE_SETUP.md) |\n\n---\n\n## Docs\n\n**[manojmallick.github.io/sigmap](https://manojmallick.github.io/sigmap)**\n\n| Section | Link |\n|---|---|\n| CLI reference (32 commands) | [cli.html](https://manojmallick.github.io/sigmap/guide/cli.html) |\n| Benchmark methodology | [benchmark.html](https://manojmallick.github.io/sigmap/guide/benchmark.html) |\n| Config reference | [config.html](https://manojmallick.github.io/sigmap/guide/config.html) |\n| Roadmap | [roadmap.html](https://manojmallick.github.io/sigmap/guide/roadmap.html) |\n| 29 languages | [generalization.html](https://manojmallick.github.io/sigmap/guide/generalization.html) |\n\n---\n\n## Support\n\nIf SigMap saves you context or API spend, a ⭐ on [GitHub](https://github.com/manojmallick/sigmap) helps others find it.\n\n[Report an issue](https://github.com/manojmallick/sigmap/issues) · [Changelog](CHANGELOG.md)\n\n---\n\n## Contributing\n\nSigMap welcomes contributions! \n\n**Before submitting a PR:**\n1. Read [CONTRIBUTING.md](CONTRIBUTING.md)\n2. Check [Discussions → Announcements](../../discussions) for workflow setup\n3. Target the `develop` branch (not main)\n4. Follow the [contributor checklist](.github/CONTRIBUTOR_CHECKLIST.txt)\n\nSee [.github/PULL_REQUEST_TEMPLATE.md](.github/PULL_REQUEST_TEMPLATE.md) for the PR checklist. All contributors are credited in the CHANGELOG and release notes.\n\n---\n\n## Why not embeddings?\n\n| | Embeddings | SigMap |\n|---|:---:|:---:|\n| Vector DB required | ✅ | ❌ |\n| Infrastructure to run | ✅ | ❌ |\n| Drift over time | ✅ | ❌ |\n| Deterministic results | ❌ | ✅ |\n| Zero-config setup | ❌ | ✅ |\n| Works offline | ❌ | ✅ |\n\n- **No vector DB** — signatures are plain text files committed to your repo\n- **No infra** — runs locally, zero cloud dependencies\n- **No drift** — regenerating is `npx sigmap`, not a reindex pipeline\n- **Deterministic** — same input always produces same ranked output\n- **Faster** — TF-IDF ranking runs in milliseconds, no embeddings to compute\n\n---\n\n## 29 languages\n\nTypeScript · 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\n\nAll implemented with zero external dependencies.\n\n[Full language table →](https://manojmallick.github.io/sigmap/guide/generalization.html)\n\n---\n\n## License\n\nMIT © 2026 [Manoj Mallick](https://github.com/manojmallick) · Made in Amsterdam\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**[Docs](https://manojmallick.github.io/sigmap) · [Changelog](CHANGELOG.md) · [Roadmap](https://manojmallick.github.io/sigmap/roadmap.html) · [npm](https://www.npmjs.com/package/sigmap)**\n\n⭐ [Star on GitHub](https://github.com/manojmallick/sigmap) if SigMap saves you tokens.\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanojmallick%2Fsigmap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanojmallick%2Fsigmap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanojmallick%2Fsigmap/lists"}