Most "I cut my token usage by X%" posts hand-wave the number. This one shows the method, the repos, and the case where the tool does basically nothing. I'd rather you trust the result than be impressed by it.
The problem: agents read whole files to see three lines
Watch a coding agent work on a large codebase and you'll see the same loop over and over:
grep -rn "handlePayment" src/→ a dozenfile:linehits.
Readfour of those files in full — hundreds of lines each — just to see the ~10 lines around each hit.- Repeat for the next symbol.
Each whole-file read is hundreds to thousands of tokens of context the model didn't need, and each one is another round trip. On a small repo it's invisible. On a real codebase it compounds into a slow, expensive session — and eventually a context window stuffed with files the agent only glanced at.
The native tools aren't wrong; they're just coarse. Grep finds lines, Read returns files, and the agent is left to staple them together at full token cost.
Parecode: search that returns context, not files
.
- Repo: https://github.com/BasilSkyWalk/parecode
npm install -g parecode
If you want a low-commitment gut check first, parecode stats --retroactive estimates how much it would have saved across your past Claude Code sessions (estimated, not measured — but a fair signal for your workflow).
If you run it for real, I'd like to hear what numbers you get — especially the cases where it doesn't help, since that's where the next version gets better. Issues and PRs welcome.
SOCIAL SHARE CARD GENERATOR