Pheebs icon

Pheebs

Pheebs 是開源遙測工具,了解開發者如何使用 Claude Code、Cursor 與 Codex,分析模型支出、驗證習慣、返工與採用情況,且一般事件記錄不儲存程式碼或原始提示文字。

Pheebs

Pheebs 概覽

Pheebs 是 Eversynced 推出的開源遙測工具,用於衡量開發者如何使用 AI 程式設計代理程式工作。它透過 hooks 連接 Claude Code、Cursor 與 Codex,記錄與工作階段、模型、提示、工具、驗證及協同執行相關的互動訊號,而不是儲存工作內容。

此工具旨在協助團隊了解模型支出、工作流程熟練度與代理程式功能的採用情況。Pheebs 可在本機運作,也可將事件傳送至自架或由 Eversynced 管理的後端,透過完整的工作階段資料檢視模型適配性、驗證習慣、返工與啟用模式。

主要功能

代理程式工作流程遙測

透過 hooks 連接 Claude Code、Cursor 與 Codex,記錄工作階段開始與結束、提示、模型變更、工具呼叫、失敗、壓縮、背景工作及相關工作流程事件。

最小化內容擷取

儲存事件類型、持續時間、計數、模型選擇、觸發類型、提示長度與選用的意圖標籤等輕量欄位,而非底層互動文字。

能力與支出分析

利用工作規模、模型選擇、努力程度設定、驗證活動、修復提示與相關訊號,評估模型能力是否符合工作需求,並估算潛在支出差距。

本機優先的事件管線

保留持久的本機 JSONL 副本,並可將事件轉送至已設定的後端,且不會阻塞程式設計代理程式;傳輸失敗會非同步處理,用戶端不會重試。

後端彈性

透過基礎 URL 與開發者權杖,支援自架或由 Eversynced 管理的後端,並提供已記錄的資料攝取、驗證、選用提示分類、洞察與 OTLP 轉送路由。

OpenTelemetry 支援

透過 Pheebs proxy 為 Claude Code 與 Codex 設定原生 OpenTelemetry 匯出,同時由 hooks 為所有支援的代理程式提供主要事件擷取路徑。

使用情境

  • 找出可避免的模型支出

    檢視模型選擇與工作範圍、努力程度設定及修復提示的關係,找出使用了超出工作需求之較大型號的工作階段,或因能力不足的選擇而產生返工的情況。

  • 改善驗證實務

    衡量 AI 產生的變更後是否執行測試、型別檢查、建置或審查,協助團隊了解代理程式迴圈中哪些地方有驗證、哪些地方缺少驗證。

  • 評估代理程式啟用成效

    追蹤 skills、斜線指令、子代理程式、內容檔案、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 proxy 匯出原生 OpenTelemetry 指標與記錄;Cursor 則沒有由 Pheebs 設定的原生 OpenTelemetry 匯出功能。

Quick Facts

分類
開發者工具
產品類型
開源 AI 遙測
支援的代理程式
Claude Code、Cursor、Codex
安裝方式
npm install -g pheebs,然後執行 pheebs init
儲存方式
預設為本機 JSONL;可選擇傳送至後端
後端選項
自架或由 Eversynced 管理