Skip to content

Commit b94e1a4

Browse files
jgravelleclaude
andcommitted
docs(README): SEO pass — live-telemetry stats callout, Token Cost Radar link, FAQ
- Add a verified live-stats callout (313B+ tokens / 45k+ devs / $1.58M+ / 37.5k+ kg CO2, sourced from jcodemunch.com live telemetry) above the value prop. - Keyword-tune the H2 ("...with precise symbol retrieval"). - Cross-link the daily Token Cost Radar alongside the observatory. - Add an FAQ (savings, monorepos, languages, clients, free-for-personal, vs RAG/grep) targeting long-tail search intent. Repo About also updated separately: benefit-front-loaded description with the 313B+ figure, homepage fixed legacy j.gravelle.us -> jcodemunch.com, topics expanded to 20 (dropped the competitor name + generic token/tokens). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent c9e5e00 commit b94e1a4

1 file changed

Lines changed: 45 additions & 1 deletion

File tree

README.md

Lines changed: 45 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,10 @@ A crapload of detailed info: http://jcodemunch.com/
2828
of Express, FastAPI, Gin, Pydantic, Django, Flask, NestJS, Cobra, and
2929
this very repo: https://jgravelle.github.io/jcodemunch-observatory/
3030

31+
**Token Cost Radar** — daily intelligence on AI token costs, minimization
32+
strategies, and budget trends for teams running Claude Code / Cursor / MCP:
33+
https://jcodemunch.com/radar/
34+
3135
<!-- mcp-name: io.github.jgravelle/jcodemunch-mcp -->
3236

3337

@@ -39,7 +43,11 @@ Our guarantee: If jCodeMunch doesn't pay for itself, you don't pay for jCodeMun
3943
---
4044

4145

42-
## Cut code-reading token usage by **95% or more**
46+
> ### Real results, live from production
47+
> **313+ billion tokens saved** · **45,000+ developers** · **$1.58M+ in AI spend avoided** · **37,500+ kg CO₂ prevented**
48+
> Live telemetry at **[jcodemunch.com](https://jcodemunch.com/)** — benchmark: **95% average token reduction** across 15 tasks / 3 repositories.
49+
50+
## Cut code-reading token usage by **95% or more** with precise symbol retrieval
4351

4452
Most AI agents explore repositories the expensive way:
4553

@@ -942,6 +950,42 @@ suite stays usable in plan mode.
942950
943951
</details>
944952
953+
## FAQ
954+
955+
**How much can I save on Claude / Opus tokens?**
956+
In retrieval-heavy workflows, code-reading tokens typically drop **95%+** because
957+
the agent fetches exact symbols instead of brute-reading whole files — benchmarked
958+
at a 95% average reduction across 15 tasks / 3 repositories, with peaks of 99.8%
959+
on large repos. Compact [MUNCH](SPEC_MUNCH.md) encoding then trims another ~45%
960+
off the wire. Full methodology and harness: [TOKEN_SAVINGS.md](TOKEN_SAVINGS.md)
961+
and [benchmarks/](benchmarks/).
962+
963+
**Does it work with large monorepos?**
964+
Yes. It indexes incrementally, detects workspace members (pnpm / yarn / npm /
965+
Turborepo / Cargo / Go workspaces), and scopes queries to subpaths, so retrieval
966+
stays cheap as the repo grows. A file watcher keeps the index fresh.
967+
968+
**What languages are supported?**
969+
70+ languages, including Python, JavaScript/TypeScript, Go, Rust, Java, C/C++,
970+
C#, PHP, Ruby, Swift, and Kotlin via tree-sitter AST parsing. Full matrix:
971+
[LANGUAGE_SUPPORT.md](LANGUAGE_SUPPORT.md).
972+
973+
**Which agents and IDEs does it work with?**
974+
Any MCP client — Claude Code, Cursor, VS Code, Codex CLI, Continue, Windsurf,
975+
and more. One-click and CLI installs are at the [top of this README](#one-click-installs)
976+
and in the [Works With](#works-with) section.
977+
978+
**Is it free for personal use?**
979+
Yes — free for personal use; commercial use needs a license. See
980+
[Commercial Licenses](#commercial-licenses). The guarantee: if jCodeMunch doesn't
981+
pay for itself, you don't pay for it.
982+
983+
**How is this different from RAG or grep-based tools?**
984+
jCodeMunch retrieves at the **symbol level** with byte-level precision —
985+
functions, classes, importers, blast radius, class hierarchies — rather than
986+
returning fuzzy chunks (RAG) or raw line matches (grep) that the agent still has
987+
to read and reason over. Index once, query exactly what you need.
988+
945989
## Star History
946990
947991
<a href="https://www.star-history.com/?repos=jgravelle%2Fjcodemunch-mcp&type=date&legend=top-left">

0 commit comments

Comments
 (0)