Bough 会话工作与成本分析器
把 Claude Code、Codex CLI 和 Pi 的会话记录整理成可浏览的工作图,并按任务估算 API 标价。
- Star 数
- ★ 118
- 最近更新
- 10 天前
- License
- MIT
- 主语言
- Go
- FA 评分
- 77/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 的个人开发者,想按功能或某个工作时段回看提示、失败和费用。
- 不适合
- 需要按订阅账单而非 API 标价核算费用的团队
- 依赖经过广泛验证的 Codex 或 Pi 统计的用户
- 源码审查
- 77/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
Bough 是一个 Go 命令行程序,读取 Claude Code、OpenAI Codex CLI 和 Pi 保存在本机的会话记录,并把提示、任务和工作时段组织成项目视图。运行 `bough` 会在浏览器打开仅监听 `127.0.0.1` 的本地页面,展示工作图、提示全文、任务成本和 Git 提交信息。它也能通过 `--text` 输出终端列表,或用 `--json` 导出不含布局样式的工作结构。项目以单个二进制文件运行,默认离线工作,不调用模型、不发送数据;读取历史记录和项目 Git 历史时只读。成本按模型公布的 API 费率估算,并非订阅账单;项目处于早期阶段,分组阈值基于一位开发者的历史拟定。
运行 bough 后,程序自动查找 Claude Code、Codex CLI 和 Pi 的历史记录,按项目读取提示、工具、文件、提交及 token 计数。它将提示归并为任务,再把任务汇总为工作时段;页面用图形呈现这些层级,点击节点可查看对应的原始提示记录。Bough 读取记录中注明路径的本地 Git 历史,以核对提交;--no-repo 可关闭这项读取。它依据内置的已公布费率计算任务和项目的估算成本;对没有已公布费率或按请求大小收费的模型,显示 token 数并将金额标为 NA。用户可用 --agent 选择数据来源,用 --text、--json 或 -o 选择输出方式,并可通过 --rename 给项目改名。
- 使用 Claude Code 的个人开发者,想按功能或某个工作时段回看提示、失败和费用。
- 在 Claude Code、Codex CLI 与 Pi 之间切换的开发者,想把多个工具的本地项目记录放在同一列表里查看。
- 需要把工作记录导出到脚本或其他分析流程的用户,可用
--json获取工作结构。 - 偏好终端工作流的开发者,可用
--text查看任务列表,或将结果写入文件。 - 想核对会话里记录的提交与项目 Git 历史的开发者,可查看提交信息并在必要时关闭仓库读取。
如何安装或部署这个 Agent?
macOS 可通过 Homebrew 安装:
brew install nickelsec/tap/boughLinux 或未安装 Homebrew 的 macOS,可运行:
curl -fsSL https://www.bough.run/install.sh | shWindows 可运行:
irm https://www.bough.run/install.ps1 | iex也可使用 Go 安装:
go install github.com/nickelsec/bough/cmd/bough@latest自行构建:
git clone https://github.com/nickelsec/bough
cd bough
go build ./cmd/boughREADME 说明安装脚本会核对发布校验和;不需要 API 密钥或模型服务。自行构建需要 Go;项目列出一个依赖 golang.org/x/term。
如何使用这个 Agent?
首次运行:
bough它会查找项目并在浏览器打开本地页面。按需使用命令行选项:
bough --text
bough --json
bough --agent=pi
bough --no-repo
bough --root DIR
bough project-one --rename "Portfolio site"--text 输出终端列表,--json 输出工作结构,--agent 可设为 claude、codex、pi 或 all,--root 指定历史记录目录。也可以用 bough project-one 打开指定项目,或用 bough -o notes.txt 将输出写入文件。
这个 Agent 有哪些优点和局限?
- 将提示、任务和工作时段分层呈现,让用户能查看单个任务而不只看跨多周的会话。
- 同一工具自动读取 Claude Code、Codex CLI 和 Pi 的历史,并支持按代理筛选。
- 内置公布费率,无需联网即可估算有公开费率模型的任务成本;不支持定价的模型会显示 NA。
- 提供本地浏览器图形界面、终端文本输出和 JSON 导出三种查看或处理路径。
- 任务分组阈值依据一位开发者的历史拟定,其他人的任务边界可能不合适。
- README 表示 Codex 和 Pi 支持较新、曝光较少,相关统计需要更谨慎看待。
- 成本是按公布 API 费率估算,不反映用户实际订阅方案或账单。
- 未知费率或按请求大小计价的模型只显示 token 计数,不提供金额估算。
这个 Agent 与同类方案有什么区别?
README 将 Bough 与 Claude Code 的 /stats 区分:/stats 展示使用统计,Bough 则将工作拆分为任务并估算各部分成本。README 也指出,通常的使用工具以会话为粒度;Bough 试图从会话中划分任务。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Bough 会话工作与成本分析器 当前 | 77 · 表现良好 | 命令行工具免费 | ★ 118 | 10 天前 | Go | Codex · Claude Code |
| ChatLab 聊天记录分析工具 | 42 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 7.5k | 今天 | TypeScript | — |
| Principia | 66 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.1k | 10 天前 | Rich Text Format | — |
| optim-agent | 65 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 801 | 1 个月前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
权限与副作用:README 将功能限定为读取本机 Claude Code、Codex、Pi 历史及可选 Git 历史;服务绑定 127.0.0.1,默认无网络,只有重命名时写入自身设置目录,且可用 --no-repo 关闭 Git 读取,说明较充分(least_privilege=3、external_effects=3)。安装脚本会下载并安装二进制,说明列出校验和;该操作有说明,但未描述运行时逐步确认,因此 user_confirmation=2。数据流说明具体到输入、输出与本地处理,但历史中的完整提示词可能含敏感信息,文件没有显示脱敏或敏感内容保护措施,故 sensitive_data_handling=1。依赖仅声明 x/term 与间接 x/sys,CI 有安全扫描和 CodeQL;缺少依赖审计结果,dependency_security=2。回滚方面,项目历史与代理目录只读,重命名文件位置已说明,但未描述恢复或撤销重命名的流程,rollback=2。文件明确写出作者版权,但未提供经验证的发布者身份或更广泛的维护者归属证据,source_attribution=2。
README、SECURITY 与 CI 对本地只读、loopback 服务和不发送数据的描述基本一致;CI 声明多平台构建、测试、静态分析与模糊测试,但本评估不把这些声明当作已执行验证,self_consistency=2。Go 模块依赖少,嵌入式页面和离线费率降低运行时外部依赖;仍需 Go 获取构建依赖,且安装渠道依赖发布服务,dependency_availability=2。文档提到无效费率显示 NA、Git 仓库不可用时继续,但对解析错误、权限错误等用户可见失败信息描述有限,failure_messages=1。
用途和受众清楚:面向使用 Claude Code、Codex CLI 或 Pi、希望按项目/任务查看时长、提示词和估算成本的个人开发者;还列出图形界面、文本、JSON、筛选等情景,audience_and_scenarios=3。边界描述具体,包括不声称实际账单、不支持其他代理、费用可能为 NA、分组阈值按单人历史拟合,capability_boundaries=3。命令行选项覆盖项目选择、输出形式、代理筛选和 Git 读取开关,但自动发现历史目录的触发条件与异常路径未完整展开,trigger_precision=2。提供 macOS、Linux、Windows 安装方式及跨平台 CI 说明;但部分安装依赖 shell/PowerShell 和网络,environment_fit=2。
README 按使用、功能、限制、格式、结构和贡献组织,导航清晰,information_architecture=3。安装文档给出多平台命令、手动安装、Go 安装、升级行为及校验和说明,install_notes=3。命令名与主要术语较稳定,但没有 API 或兼容性政策,naming_stability=2。提供多个 CLI 示例和逐步功能说明,却没有独立 FAQ 或更丰富的故障排查内容,examples_and_faq=2。限制涵盖估算费用、单人拟合阈值、代理覆盖范围、Git 计数差异及早期状态,known_limitations=3。仓库含 MIT 许可证文本,license=3。安全文档称暂无发行版、修复进入 main;没有变更日志或明确版本支持表,versioning_changelog=1。贡献指南、问题/PR 邀请和安全报告渠道提供维护入口,但没有明确维护团队或响应承诺以外的责任信息,maintenance_responsibility=2。
图形界面、可定位到原始提示词的记录、按任务估价及文本/JSON 导出都便于检查和后续使用,output_usability=3。将散落会话整理为任务、坐席时段、文件与费用,且明确指出现有工具的粒度局限,展现出具体增量价值,marginal_value=3。单二进制、轻量依赖和本地处理有利于低运行成本,但分析效果依赖历史格式及个人拟合阈值,cost_benefit=2。
文档指向仓库内的格式说明、调参说明和代码目录,也说明了 Git 提交与代理记录的差异;不过许多功能与安全主张仍主要来自 README 自述,claim_traceability=2。README、SECURITY、模块文件和 CI 在边界与实现方式上有一定相互印证,但未提供独立审计结果,且 CI 内容只是配置证据,cross_source_corroboration=2。文档区分代理记录、Git 中保留的提交、估算费率和实收费账单,并明确指出拟合阈值及评估局限,事实与推断的界线处理充分,fact_inference_separation=3。
- 费用是按公开 API 费率估算,不代表实际账单;订阅费用、无公开费率的模型和按请求规模计费的模型可能无法准确换算。
- 工具会读取并展示完整提示词及本机代理历史;请确认这些记录适合在本机浏览器中查看,并谨慎处理可能包含敏感信息的历史。
- 任务分组阈值按单一开发者的历史拟合;Codex 与 Pi 支持曝光较少,README 明确建议对其统计结果保持怀疑。
常见问题
显示的费用就是我的账单金额吗?
它会把会话记录或仓库内容上传吗?
names.json。它支持哪些编码助手?
--agent=claude、--agent=codex、--agent=pi 或 --agent=all 选择。如果项目目录已移动或不是 Git 仓库,还能使用吗?
--no-repo 关闭仓库读取。