Pheebs icon

Pheebs

Pheebs 是一款开源遥测工具,用于分析开发者使用 Claude Code、Cursor 和 Codex 的方式,了解模型支出、验证习惯、返工与采用情况,同时不在常规事件记录中存储代码或原始提示文本。

Pheebs

Pheebs 概览

Pheebs 是 Eversynced 推出的开源遥测工具,用于衡量开发者如何使用 AI 编码代理。它通过钩子连接 Claude Code、Cursor 和 Codex,记录有关会话、模型、提示、工具、验证和编排的交互信号,而不是存储工作内容。

该工具旨在帮助团队了解模型支出、工作流熟练度以及代理能力的采用情况。Pheebs 可以在本地运行,也可以将事件发送到自托管或由 Eversynced 管理的后端,在那里可利用完整的会话数据分析模型适配性、验证习惯、返工和赋能模式。

主要功能

代理工作流遥测

通过钩子接入 Claude Code、Cursor 和 Codex,记录会话开始与结束、提示、模型变更、工具调用、失败、压缩、后台任务及相关工作流事件。

最小化内容采集

存储事件类型、持续时间、计数、模型选择、触发类型、提示长度和可选意图标签等轻量字段,而不是底层交互文本。

能力与支出分析

利用任务规模、模型选择、工作量设置、验证活动、修复提示及相关信号,评估模型能力是否与工作匹配,并估算潜在支出差距。

本地优先的事件管道

保留持久化的本地 JSONL 副本,并可将事件转发到已配置的后端,且不会阻塞编码代理;传输失败会异步处理,客户端不会重试。

灵活的后端支持

通过基础 URL 和开发者令牌,支持自托管或由 Eversynced 管理的后端,并提供事件接收、验证、可选提示分类、洞察和 OTLP 透传的文档化路由。

支持 OpenTelemetry

通过 Pheebs 代理为 Claude Code 和 Codex 配置原生 OpenTelemetry 导出,同时钩子为所有受支持的代理提供主要事件采集路径。

使用场景

  • 发现可避免的模型支出

    根据任务范围、工作量设置和修复提示审查模型选择,找出工作本不需要使用更大模型的会话,或因选择能力不足的模型而产生返工的会话。

  • 改进验证实践

    衡量 AI 生成的变更之后是否进行了测试、类型检查、构建或审查,帮助团队了解代理循环中哪些环节进行了验证、哪些缺少验证。

  • 评估代理赋能

    跟踪技能、斜杠命令、子代理、上下文文件、MCP 连接及其他代理配置的重复使用情况,以确定哪些赋能投入真正被采用。

  • 研究团队工作流

    利用会话、编排、压缩、后台任务和工具失败等信号,了解团队中开发者如何组织 AI 辅助工作,同时不收集项目内容。

Pros and Cons

Pros

  • 开源客户端支持仅本地运行,只需不设置后端端点即可。
  • 在常规事件记录中不存储源代码、文件内容、文件路径或原始提示文本,仅采集工作流元数据。
  • 同时支持自托管和由 Eversynced 管理的后端方案。
  • 为 Claude Code 和 Codex 提供文档化的后端契约及 OpenTelemetry 路径。
  • 将遥测与模型适配性、验证、返工和采用情况分析相结合,而不只是报告模型使用情况。

Cons

  • 公开资料未说明定价,也未完整介绍托管服务方案。
  • 可选的提示分类功能会将原始提示文本发送到配置的后端;该功能需要显式配置,并且可以禁用。
  • 该工具围绕三个指定的编码代理设计,现有证据无法证明其支持其他代理。

FAQ

如何安装 Pheebs?

使用 npm install -g pheebs 全局安装 Pheebs,然后运行 pheebs init。交互式设置会检测 Claude Code、Cursor 和 Codex,配置选定的代理,并可使用 pheebs doctor 进行验证。

遥测数据会离开开发者的设备吗?

默认情况下,Pheebs 会将事件写入 ~/.pheebs/logs/ 中的本地 JSONL 日志。只有在同时配置了基础 URL 和令牌后,事件才会发送到后端。将端点留空即可保持仅本地运行。

Pheebs 会捕获哪些信息?

Pheebs 会记录事件类型、持续时间、计数、模型、触发类型、工具意图和提示长度等交互信号。它不会将源代码、文件内容、文件路径、目录结构、提示文本或命令字符串作为原始文本存储。可选的提示分类功能会将提示文本发送到配置的后端,并且只存储返回的标签。

团队可以使用自己的后端吗?

Pheebs 可以使用自托管后端或由 Eversynced 管理的后端。客户端与后端无关,通过基础 URL 和每位开发者的令牌进行连接;文档化的契约包括事件接收、令牌验证、可选的提示分类以及 OTLP 透传。

Pheebs 支持哪些编码代理?

Pheebs 专为 Claude Code、Cursor 和 Codex 设计。Claude Code 和 Codex 还可以通过 Pheebs 代理导出原生 OpenTelemetry 指标和日志;Cursor 没有配置由 Pheebs 提供的原生 OpenTelemetry 导出。

Quick Facts

类别
开发者工具
产品类型
开源 AI 遥测
支持的代理
Claude Code、Cursor、Codex
安装
npm install -g pheebs,然后运行 pheebs init
存储
默认使用本地 JSONL;可选发送到后端
后端选项
自托管或由 Eversynced 管理