JuliusBrussee/caveman
A tool that makes AI coding agents talk like cavemen and read less, to cut token costs
Caveman started as a skill that makes Claude Code and similar coding agents answer in short, blunt sentences, cutting output tokens. It has grown into a local proxy that also compresses what the agent reads every turn, including tool schemas, files, logs, and history. In a pinned benchmark it cut provider-reported input tokens by 33.2%, while the original skill cuts output tokens by an average of 65%.
What it does
- Began by shortening agent replies, and now also compresses what the agent reads: tool descriptions, files, logs, and conversation history
- A local proxy applies different compression per content type (code, JSON, logs, search results), always keeping the original bytes on disk so they can be recovered exactly
- A 'pixel mode' renders dense text into PNG images for vision models, since image tokens are cheaper than the equivalent text tokens
- In a pinned 54-run benchmark it used 33.2% fewer input tokens than plain Claude Code while passing all 18 exact-answer checks
- The README explicitly notes the original skill only shrinks output tokens, not input or reasoning tokens, and the skill itself adds roughly 1,000-1,500 input tokens per turn
Why it matters
For developers who rely heavily on AI coding agents, token usage translates directly into cost and latency, and this project shows there is real room to save by shrinking not just replies but everything the agent reads. It's also notable for publishing an 'honest numbers' document that spells out when the savings do and don't hold, which matters for judging how much to trust the claims.
Terms in this repo
- token · the unit AI models process text in; usage cost is usually billed per token
- proxy · a middle server that sits between the agent and the AI provider to intercept, compress, and restore data
- MCP · a standard interface that lets AI agents call external tools
- TOON · the project's own format for re-encoding JSON tool results into a smaller size
Repository description (English)
Claude Code skill that cuts 65% of tokens by talking like caveman
Open on GitHubTrending repos
- vorssaint/vorssaint-utilsOne free menu bar app replaces a dozen paid Mac utilities
- Alishahryar1/free-claude-codeA local proxy that lets coding AI agents run on 49 free or cheap model providers instead of one paid service
- freestylefly/awesome-gpt-image-2A library of 532 reverse-engineered prompts that turn GPT-Image2 into a predictable image-making tool
- block/buzzAn open-source workspace where humans and AI agents chat, code, and review in the same rooms
- NousResearch/hermes-agentNous Research's Hermes is an AI agent that gets smarter the more you use it
- virgiliojr94/book-to-skillA tool that turns technical book PDFs into on-demand reference skills for AI coding agents
- VoltAgent/awesome-agent-skillsA single hub collecting over 1000 'how-to' manuals that make AI coding assistants act like experts
- anthropics/claude-plugins-communityA shared shelf where anyone's Claude add-ons get listed for install