JuliusBrussee/caveman

Caveman – AI 编码代理的 token 节省层

它是什么

• 一个基于 CLI 的代理，位于你和任何由 LLM 驱动的编码助手（Claude、Gemini、OpenAI 等）之间，将答案和输入重写得更短，同时保留确切的代码和含义。
• 它作为一个可以开启/关闭的“石头”，具有六个独立功能：
  1. 少说 – 强制模型以简洁、受控的英语风格回答（例如，New object ref each render, so React re-renders. Wrap the prop in useMemo.），减少输出 token。
  2. 少读 – 在模型读取之前压缩日志、CSV、JSON、YAML、测试输出等，在典型会话中将输入 token 减少约 33%。
  3. 自动 – 自动为每个请求选择最便宜的模型和努力级别，与高努力级别的 Claude Opus 运行相比，节省约 54% 的成本。
  4. 块 – 一个代码模式缓存，存储代理重复编写的脚本，重复使用它们而不是重新生成，将每次运行的 token 使用量从数百降至数十。
  5. 浪费修复 – 分析过去的会话以定位 token 密集型模式并提出修复建议；还在你暂停时保持 Anthropic 提示缓存温暖。
  6. 浏览 – 获取网页并返回高度压缩的版本（例如，121 个 token 对比 15k 原始 token）。

为什么重要

• LLM 定价通常按 token 计算；同时减少输入和输出 token 可以将编码会话的成本减半或更多，而不会降低答案质量（该仓库引用了与 Adobe Research、JetBrains 和 Elastic 的 A/B 测试，显示没有可测量的质量损失）。
• 该工具与模型无关：安装后它会自动包装 Claude、Gemini、OpenAI 以及 30 多个其他代理。

安装

npx @caveman-ai/cli@latest   # 一行命令，适用于 macOS、Linux、Windows（Node 22.13+）

• 安装程序会发现你的代理，询问任何需要的登录信息，然后默认激活所有六个“石头”。
• 你可以稍后使用 caveman on|off <rock> 切换单个“石头”，或禁用整个代理。

核心命令

命令	用途
caveman claude	为任何支持的代理启动启用了 Caveman 的编码会话。
caveman status	显示哪些“石头”处于活动状态以及哪些代理被包装。
`caveman on	off `
cavelon learn	分析你的 token 使用历史并提出修复建议。
/caveman, /ultracave, /megacave	聊天内快捷方式，切换回答风格（不同的 token 预算、多语言）。
/caveman-compress <file>	在模型读取之前压缩本地文件（日志、JSON 等）。
caveman-blocks scan	列出代理重复重写的脚本；块让代理重用它们。

影响证据

• 在 CSV、日志、YAML、JSON 和测试输出的混合套件中，输入 token 减少 33.2%。
• 使用自动模式时，在 85 任务编码基准上成本降低 54%。
• 应用块时，单个测试运行脚本的 token 从 397 → 76。
• Adobe Research（成本降低 1.4-2.4 倍）、JetBrains（无质量损失）和 Elastic（响应 token 减少 63.6%）的独立验证。

谁应该使用它

• 依赖 LLM 驱动的代码助手并希望保持 API 账单低廉的开发人员。
• 部署内部 AI 代理的团队（Caveman Cloud 附加组件为生产代理提供可观测性、评估和自动驾驶建议）。
• 任何熟悉基于 Node 的 CLI 并愿意让一个薄代理重写模型输出以追求简洁的人。

链接

• 文档和安装指南：./INSTALL.md
• 完整基准测试详情：./docs/WRAP-BENCHMARK.md、./docs/AUTO-BENCHMARK.md
• 云产品：https://caveman.so