caveman

环境要求

• Node.js 22.13+（完整安装脚本需要）
• 可用的 npm / npx 环境
• 一个受支持的 AI 编码 agent（Claude Code、Codex、Gemini、Cursor、Cline、Copilot 等 30+ 种）
• Windows 使用完整安装脚本需 PowerShell 5.1+

安装与启动步骤

1. 1安装小石头技能

   一条命令把 caveman 规则文件装进你现有的 agent，MIT 免费，支持 30+ 种 agent。

   npx skills add JuliusBrussee/caveman

   复制

2. 2在 agent 内激活

   如果 agent 没有自动生效，在对话里输入 /caveman 手动唤醒，安装到此结束。

   /caveman

   复制

3. 3安装大石头代理

   全局安装 caveman CLI 并执行 setup 完成本地配置，代理跑在你机器上、位于 agent 与模型服务之间。

   npm install -g @caveman-ai/cli && caveman setup --install

   复制

4. 4用代理启动 agent

   通过 caveman 包装启动你的 agent，它在每次调用前压缩 agent 读取的内容。

   caveman claude

   复制

5. 5切换其他 agent

   把 claude 换成 codex、gemini、aider、kilo、qwen、opencode、hermes、openclaw 或 pi 即可。

   caveman codex

   复制

6. 6运行完整安装器

   macOS/Linux 上自动接好 Claude Code hooks、状态栏徽章并探测本机所有受支持 agent，可安全重复执行。

   curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/v2.6.0/install.sh | bash

   复制

7. 7Windows 安装

   在 PowerShell 5.1+ 中执行同等功能的安装脚本，效果与 macOS/Linux 版本一致。

   irm https://raw.githubusercontent.com/JuliusBrussee/caveman/v2.6.0/install.ps1 | iex

   复制

如何确认成功

在 agent 中提问，回答变成原始人式极简风格；或执行 caveman claude 能正常启动并返回压缩后的内容。

常见问题

注意事项

• 完整安装器会自动查找本机所有受支持的 agent，并跳过未安装的 agent，可安全重复执行。
• 代理会压缩 agent 读取的内容，但每处压缩都在磁盘留有备份，agent 随时可拉回原文。
• 完整安装脚本需要 Node.js 22.13+，Windows 需 PowerShell 5.1+。
• 代理 CLI 为 MIT，运行时为 BSL-1.1；技能部分为 MIT 永久免费。