{"id":47770687,"url":"https://github.com/manojmallick/sigmap","last_synced_at":"2026-06-17T01:02:04.901Z","repository":{"id":348373366,"uuid":"1197711007","full_name":"manojmallick/sigmap","owner":"manojmallick","description":"97% token reduction for AI coding sessions — zero deps, 31 languages, MCP server","archived":false,"fork":false,"pushed_at":"2026-06-13T23:11:57.000Z","size":90521,"stargazers_count":511,"open_issues_count":3,"forks_count":34,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-13T23:21:51.930Z","etag":null,"topics":["ai","claude","cli","code-context","code-intelligence","context-compression","copilot","cursor","developer-experience","developer-tools","gemini","github-copilot","llm","mcp","nodejs","openai","retrieval","token-reduction","vscode","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":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","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},"funding":{"github":["manojmallick"]}},"created_at":"2026-03-31T20:17:51.000Z","updated_at":"2026-06-13T23:08:57.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":108,"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":34429493,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"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","cli","code-context","code-intelligence","context-compression","copilot","cursor","developer-experience","developer-tools","gemini","github-copilot","llm","mcp","nodejs","openai","retrieval","token-reduction","vscode","zero-dependencies"],"created_at":"2026-04-03T09:05:19.340Z","updated_at":"2026-06-17T01:02:04.895Z","avatar_url":"https://github.com/manojmallick.png","language":"JavaScript","funding_links":["https://github.com/sponsors/manojmallick"],"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\n**Model-agnostic.** Works with:\n- **Cloud LLMs:** Claude, GPT-4, Copilot, Gemini\n- **Open-source agents:** OpenCode, Aider, OpenHands, Cline\n- **Local LLMs:** Ollama, llama.cpp, vLLM (no API keys, full privacy)\n- **Any editor:** VS Code, Cursor, Windsurf, Neovim, JetBrains\n- **Any model:** Use what you want, no vendor lock-in\n\n---\n\n## Why SigMap?\n\n- **75.6% hit@5** — right file found in top 5 results (vs 13.6% baseline)\n- **97.0% token reduction** — average across 21 real repos\n- **52.2% task success rate** — up from 10% without context\n- **1.72 prompts per task** — down from 2.84 (39.4% fewer retries)\n- **31 languages supported** — TypeScript, Python, Go, Rust, Java, R, and 25 others\n- **No vendor lock-in** — works with any AI assistant or local LLM\n- **No API costs** — use local models (Ollama, llama.cpp, vLLM) with zero token fees\n- **Full privacy** — keep your code and context on your machine\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 — 76% 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-v7.0-main (21 repositories, including R language)\nDate      : 2026-06-14\n\nHit@5          : 75.6%   (baseline 13.6%  — 5.6× lift)\nToken reduction: 97.0%   (across 21 repos)\nPrompt reduction : 39.4% (2.84 → 1.72 prompts per task)\nTask success   : 52.2%   (baseline 10%)\nRepos tested   : 21 (JavaScript, Python, Go, Rust, Java, R, C++, C#, Dart, Swift, Ruby, PHP, Scala, Kotlin, and more)\n```\n\nMeasured on 90 coding tasks across 18 real public repos. No LLM API — fully reproducible.\n\n**Resources:**\n- [Full methodology →](https://sigmap.io/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, OpenCode |\n| `claude` | `CLAUDE.md` | Claude / Claude Code |\n| `cursor` | `.cursorrules` | Cursor, Cline |\n| `windsurf` | `.windsurfrules` | Windsurf |\n| `openai` | `.github/openai-context.md` | OpenAI API, Aider, local Ollama/llama.cpp |\n| `gemini` | `.github/gemini-context.md` | Google Gemini |\n| `codex` | `AGENTS.md` | OpenAI Codex (legacy) |\n\n```bash\nsigmap --adapter copilot   # default — works with Copilot, OpenCode\nsigmap --adapter openai    # works with Ollama, llama.cpp, vLLM, Aider\nsigmap --adapter claude    # works with Claude Code\n```\n\n**Open-source agents \u0026 local LLMs:**\n\nUse SigMap with open-source tools and fully self-hosted setups:\n- **[Open-source agents guide →](https://sigmap.io/guide/agents)** — OpenCode, Aider, OpenHands, Cline\n- **[Local LLMs guide →](https://sigmap.io/guide/local-llms)** — Ollama, llama.cpp, vLLM (no API keys, full privacy)\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** — 10 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://sigmap.io/guide/config.html) · [CI setup](docs/readmes/ENTERPRISE_SETUP.md) |\n\n---\n\n## Docs\n\n**[sigmap.io](https://sigmap.io)**\n\n| Section | Link |\n|---|---|\n| CLI reference (32 commands) | [cli.html](https://sigmap.io/guide/cli.html) |\n| Benchmark methodology | [benchmark.html](https://sigmap.io/guide/benchmark.html) |\n| Config reference | [config.html](https://sigmap.io/guide/config.html) |\n| Roadmap | [roadmap.html](https://sigmap.io/guide/roadmap.html) |\n| 31 languages | [generalization.html](https://sigmap.io/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## Sponsor\n\nSigMap 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.\n\n💜 **[Become a sponsor →](https://github.com/sponsors/manojmallick)** · see **[SPONSOR.md](SPONSOR.md)** for tiers and exactly where your support goes. Any amount helps — even $1/mo — and a ⭐ or a share counts too.\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## 31 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 · R · GDScript\n\nAll implemented with zero external dependencies.\n\n[Full language table →](https://sigmap.io/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://sigmap.io) · [Changelog](CHANGELOG.md) · [Roadmap](https://sigmap.io/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"}