Overview
Caveman makes AI coding agents say less and read less while the code stays exact. One install (npx @caveman-ai/cli@latest) patches Claude Code, Codex, Gemini CLI, OpenCode, and 30+ other agents with six components: a compressed reply voice, pre-read compression of logs and tool output, automatic model and effort selection, reusable agent-written scripts, waste fixes, and compressed web browsing. External evaluations from Adobe Research, JetBrains, and Elastic back the token savings with no measurable quality loss.
Key Features
- Say less: the agent answers in a structured short voice (63 → 20 tokens for the same fix, same code payload), with strict levels from
/cavemandown to/megacave - Read less: logs, JSON, CSV, and test output are shrunk before the model reads them — 33.2% fewer input tokens measured across 54 Claude Code runs
- Auto: picks the model and reasoning effort per request, measured 54% cheaper than a maxed-out Opus configuration at the same task score
- Blocks: the agent keeps scripts it writes and reruns them instead of re-reading output (397 → 76 tokens for one test run)
- Waste fixes find where tokens go and fix it, including keeping the prompt cache warm while you pause
- Browse returns web pages compressed (129.8x smaller page)
Use Cases
- Cutting cost and latency of daily coding-agent sessions without changing how you prompt
- Keeping subscription quotas and rate limits from interrupting long agent runs
- Running the same agent workflow across Claude Code, Codex, Gemini CLI, OpenCode, and other CLIs with one setup
- Teams wanting benchmarked token savings rather than blindly shortened answers
Technical Details
- Installed via the
@caveman-ai/clinpm package (Node 22.13+); the CLI detects installed agents and their logins and applies a prompt skill plus a local proxy layer that runs on your machine with your own keys - The voice is not broken grammar but a fixed reply structure based on ASD-STE100 controlled English: answer first, one idea per sentence, 20 words max, active voice; negations, numbers, and units are never dropped and code, commands, paths, and error text stay verbatim
- User prompts are never rewritten — external research showed compressing the user's prompt backfires; compression targets only what the agent reads (tool output) and runs on (scripts)
- The proxy compresses tool_result payloads (logs, JSON, CSV, test output) before they reach the model, translates web pages into compact form, and keeps the provider prompt cache warm across pauses
- Each of the six components can be toggled individually (
caveman status,caveman off browse); only the Auto model picker needs an account
