来源笔记
Agent-stack – one command to make any repo token-efficient for Claude Code
摘要
概述
agent-stack 是一个一条命令的设置工具，用来为 Claude Code 和 Cursor 配置更省 token 的仓库工作流。它之所以重要，是因为仓库里的 agent 常常把上下文浪费在文件发现、噪声日志、过长指令和手动配置 hooks 上。
问题
- Claude Code 的省 token 工具分散在多个独立工具里，分别处理 shell 压缩、代码映射、用量测量、交接、hooks 和编辑器规则。
- 配置一个仓库时，往往要在 5 到 10 个工具之间做选择，合并 hooks，编写 CLAUDE.md，镜像 Cursor 规则，并手动测量用量。
- 直接后果是输入 token 用量更高，而且 agent 在开始处理代码库前要花更多时间做准备。
方法
- 主命令
npx @drmahdikazempour/agent-stack init --all会检测主机、仓库类型、包管理器和 profile，然后生成 Claude Code 和 Cursor 文件。 - 它会写入并校验
CLAUDE.md、AGENTS.md、.claudeignore、skills、hooks、Cursor 规则和.agent-stack/graph.md，并在失败时保留备份和回滚。 - 内置代码映射会索引源文件和导出符号，这样 agent 可以先 grep 一个紧凑文件，再打开源文件。
- 内置的
compress命令会移除 ANSI 代码、折叠重复行，并在长命令输出进入上下文之前截短它。 - 用量测量依赖
ccusage；Stop hook 会把每次 turn 记录到.agent-stack/usage.jsonl，measure --since 7d会把当前输入 token/天与保存的基线对比。
结果
- 设置声明：
init --all可以在不到 2 分钟内把一个仓库从未配置状态变成优化后的 Claude Code 和 Cursor 设置。 - 示例安装输出声称生成了 20 个文件、接好了 2 个 hooks、验证了
CLAUDE.md、生成了代码映射，并给出了 12,340 tokens/天 的 7 天游基线。 - 生成的
CLAUDE.md限制在启动时 ≤800 tokens，并由doctor检查。 - 代码映射示例索引了 142 个文件和 906 个顶层符号，让 agent 在符号搜索时只需打开 1 个目标文件，而不是读很多文件。
- 输出压缩器声称在一个 500 行日志上大约减少 60% 的字符。
- 测量示例显示当前输入 token/天为 7,180，基线为 12,340，减少 41.8%，目标至少是 40%；这些是 README 中的声明，不是独立基准测试。