steipete/CodexBar

Show usage stats for OpenAI Codex and Claude Code, without having to login.

CodexBar – 面向 macOS 的 AI 編碼配額監控工具(Linux 也提供 CLI)

是什麼 – 一款輕量級的 macOS 14+ 菜單欄應用(附帶內建命令列工具),可即時顯示您所使用的每個 AI 編碼服務(OpenAI、Claude、Gemini、Copilot、Grok 等)的剩餘令牌/積分數量。它還能顯示服務使用週期的重置時間(每日、每週、每月),並可展示支出/積分餘額。

為何你需要它

  • 避免意外 – 查看配額重置倒計時,以便規劃長時間的程式碼生成任務。
  • 成本意識 – 對支援資料公開的服務,提供 API 使用支出和積分餘額的內聯圖表。
  • 即時狀態 – 透過輪詢提供者狀態,在菜單圖示上直接顯示事件/故障標籤。
  • 隱私優先 – 重用現有會話(OAuth、API 金鑰、瀏覽器 Cookie),從不儲存密碼;僅在啟用提供者時讀取少數已知檔案。

核心功能(詳見 README)

  • 每個提供者一個狀態項目,或啟用 合併圖示 模式,將多個圖示合併為一個帶切換器的圖示。
  • 提供者特定的使用量儀表盤,附帶重置倒計時。
  • 支援 API 後端的提供者(OpenAI、Claude Admin API、OpenRouter、LiteLLM 等)的成本/使用量圖表。
  • 持久化的 使用與支出 視圖,包含 7/30 天預測,按原生貨幣分組。
  • 提供者狀態輪詢,附帶事件標籤。
  • 可設定的刷新間隔(自適應預設值,以及固定 1 分鐘至 30 分鐘選項)。
  • 內建 CLI(codexbar),用於腳本和 CI(例如:codexbar cost --provider openai)。
  • 支援提供者的 WidgetKit 小工具。
  • 多語言本地化 UI(21 種語言)和 RTL 支援。
  • 可選的配額重置通知。
  • 無 Dock 圖示;UI 極簡,完全位於菜單欄中。

支援的提供者 – 應用內建支援超過 60 個提供者,涵蓋 OpenAI、Claude、Gemini、Azure OpenAI,以及 ElevenLabs、Deepgram、Zed、JetBrains AI、AWS Bedrock、GroqCloud、LiteLLM 等小眾服務。可透過文件化的 提供者建立指南 新增新提供者。

安裝方法

  • macOS – 從 GitHub 發布頁面下載發行版,或透過 Homebrew Cask 安裝:
    brew install --cask codexbar
    
  • Linux – 透過 Homebrew(brew install steipete/tap/codexbar)或 Arch AUR(yay -S codexbar-cli)安裝 CLI。也提供多種架構的 tarball。
  • 首次執行 – 打開 設定 → 提供者,啟用您使用的服務。按需提供 API 金鑰、OAuth 憑證或瀏覽器 Cookie。API 金鑰可透過 CLI 設定,例如:
    printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin
    

權限 – 應用可能請求:

  • 完全磁碟存取(可選):用於讀取 Web 服務的 Safari Cookie。
  • 鑰匙圈存取:用於解密 Chromium Cookie 或讀取儲存的 OAuth 憑證。
  • 資料夾/磁碟區存取:啟動外部提供者 CLI 時。 所有提示均在 README 中說明,您可在進階設定中完全停用鑰匙圈讀取。

開發 – 使用 Swift 6.2+ 為 macOS 14+ 建構。倉儲包含打包應用、執行測試、程式碼檢查和產生文件的腳本。同時為 macOS 和 Linux 建構 CLI 二進位檔。

相關專案 – 作者還維護 Trimmy(剪貼簿執行助手)、MCPorter(Model Context Protocol 用 TypeScript 工具包)和 oracle(GPT-5 風格查詢工具)。社群已為 Windows、Wayland、COSMIC、GNOME 和 Cinnamon 提供移植版本。


以上所有資訊均直接來自倉儲的 README;未推斷任何額外功能。

相關

  • 專案
  • 專案
  • 專案
  • 專案
  • 專案