TopGit
Đánh giá repo GitHub

CodexBar: theo dõi mức dùng AI ngay trên menu bar

steipete/CodexBar
CTopGit review image for steipete/CodexBar
Review by Topgit.dev for steipete/CodexBar, with GitHub repository stats and README context.
Nhận định nhanh

CodexBar là ứng dụng menu bar trên macOS giúp bạn không bị bất ngờ khi chạm giới hạn tốc độ của một nhà cung cấp AI coding giữa chừng công việc. Nó đọc dữ liệu sử dụng trực tiếp từ OAuth token, cookie trình duyệt hoặc thông tin đăng nhập CLI của từng nhà cung cấp, rồi đếm ngược đến lần reset tiếp theo. Nên dùng nếu bạn chạy từ hai gói AI coding trở lên cùng lúc; bỏ qua nếu bạn chỉ dùng một provider mà dashboard riêng đã đủ thông tin.

Sao
★ 19.7k
Fork
⑂ 1.6k
Ngôn ngữ
Swift
Giấy phép
MIT
Chủ đề
AI Tools
Cập nhật
Aug 2026
Trang chủ
GitHub

Theo dõi giới hạn AI coding của bạn với CodexBar

CodexBar là tiện ích menu bar cho macOS 14 trở lên, giữ mọi giới hạn của các nhà cung cấp AI coding hiển thị ở một chỗ, kèm đồng hồ đếm ngược đến khi mỗi khung sử dụng theo phiên, theo tuần hoặc theo tháng được reset. Nó tái sử dụng các phiên đăng nhập có sẵn - OAuth token, device flow, cookie trình duyệt, hoặc thông tin đăng nhập CLI - thay vì bắt đăng nhập lại từng provider. CLI `codexbar` đi kèm cung cấp cùng dữ liệu đó cho script và CI.

Tính năng cốt lõi để quản lý tài nguyên AI

  • Đồng hồ đếm ngược reset riêng cho từng provider theo khung phiên, tuần và tháng, để bạn biết trước khi bắt đầu một tác vụ dài liệu có bị hết hạn mức giữa chừng hay không.
  • Chế độ Merge Icons gộp mọi provider đã bật vào một icon menu bar duy nhất kèm bộ chuyển provider, thay vì một hàng icon trạng thái riêng lẻ.
  • Biểu đồ chi tiêu và mức dùng ngay trong ứng dụng cho các provider có API như OpenAI, Admin API của Claude, OpenRouter, LiteLLM, z.ai, MiniMax, Mistral và AWS Bedrock.
  • Màn hình Settings -> Usage & Spend ước tính chi phí cục bộ theo 7 và 30 ngày, nhóm theo đơn vị tiền tệ gốc của từng provider, cho những provider có lưu lịch sử chi phí.
  • Provider status polling: khi một provider gặp sự cố, CodexBar gắn nhãn incident trong menu và một lớp overlay trên icon thanh menu.
  • Widget WidgetKit cùng CLI `codexbar` đi kèm để chạy script kiểm tra chi phí, ví dụ `codexbar cost --provider codex`, từ CI hoặc terminal.
  • Có thể chỉnh khoảng thời gian refresh - mặc định là Adaptive, hoặc cố định ở 1, 2, 5, 15 hay 30 phút.
  • Ứng dụng và trang web được bản địa hóa, dùng chung một bộ 21 ngôn ngữ, có hỗ trợ RTL.
Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao

Bắt đầu: cài đặt CodexBar

Yêu cầu macOS 14 (Sonoma) trở lên. Cách đơn giản nhất là dùng Homebrew: `brew install --cask codexbar`, hoặc tải bản build trực tiếp từ GitHub Releases. CLI đi kèm được cài riêng - trên macOS cài sau khi đã có app bằng `./bin/install-codexbar-cli.sh`; trên Linux thì dùng Homebrew formula (`brew install steipete/tap/codexbar`), gói AUR trên Arch Linux (`yay -S codexbar-cli`), hoặc tải tarball bản release (bản glibc hoặc static musl cho aarch64/x86_64). Lần chạy đầu tiên: mở Settings -> Providers, bật những provider bạn dùng, rồi đăng nhập từng provider theo cách nó hỗ trợ - CLI, phiên trình duyệt, OAuth/device flow, API key, hoặc file cấu hình cục bộ.

Cấu hình nhà cung cấp AI và theo dõi mức dùng

Cấu hình provider được lưu trong một file JSON - bản cài mới dùng `~/.config/codexbar/config.json`, còn bản cài cũ vẫn đọc từ đường dẫn cũ `~/.codexbar/config.json`. Bạn có thể script hóa đúng các thao tác bật/tắt mà Settings -> Providers cung cấp: `codexbar config providers` liệt kê danh sách, `codexbar config enable --provider grok` để bật một provider, `codexbar config disable --provider cursor` để tắt. Với các provider dùng API key, bạn có thể bỏ qua giao diện Settings và đưa key vào trực tiếp qua pipe, ví dụ `printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin` - lệnh này cắt khoảng trắng thừa của giá trị, ghi nó vào file với quyền truy cập hạn chế, và bật provider đó luôn trừ khi bạn thêm cờ `--no-enable`.

Điểm mạnh

  • Không lưu mật khẩu riêng: CodexBar đăng nhập bằng cách tái sử dụng OAuth token, device flow, API key sẵn có, cookie trình duyệt, hoặc file CLI/cấu hình cục bộ bạn đã có.
  • Gom về một chỗ một danh sách provider thực sự dài - Codex, Claude, Cursor, Gemini, Copilot, Grok, GroqCloud, OpenRouter, LiteLLM, AWS Bedrock và nhiều provider khác - mỗi provider có logic khung reset riêng thay vì một bộ đếm giờ chung chung.
  • CLI `codexbar` đi kèm đưa cùng dữ liệu sử dụng ra một giao diện có thể script hóa, không bị khóa trong giao diện menu bar - hữu ích cho kiểm tra CI hoặc quy trình làm việc trên terminal.
  • Nêu rõ trong README từng quyền mà ứng dụng xin (Full Disk Access, Keychain) thay vì âm thầm yêu cầu, và liệt kê rõ những gì nó không xin ngầm (không xin Screen Recording, không xin Accessibility).

Quyền riêng tư, quyền truy cập và lưu ý nền tảng

  • Ưu tiên macOS: bản ứng dụng chính thức chỉ chạy trên macOS 14 trở lên. Người dùng Linux và Windows phải dựa vào các dự án riêng do cộng đồng làm - một CLI cho Linux cộng thêm widget panel bên thứ ba, và bản port Win-CodexBar không chính thức - chứ không phải một giao diện gốc của chính CodexBar.
  • Một số provider chỉ hoạt động qua việc lấy cookie trình duyệt thay vì một API sạch, nghĩa là CodexBar cần quyền Keychain để giải mã cookie đã lưu của trình duyệt đó - và macOS sẽ tiếp tục hỏi lại quyền này trừ khi bạn tự tay cấp "Always Allow" cho từng trình duyệt.
  • Chế độ refresh Adaptive (agent-aware) tùy chọn sẽ kiểm tra danh sách tiến trình đang chạy, kể cả dòng lệnh, để phát hiện hoạt động của Codex/Claude - đây là thiết kế mà người dùng quan tâm đến quyền riêng tư cần chủ động cân nhắc bật lên chứ không nên mặc định bỏ qua.
  • Với 19.691 sao trên GitHub, dòng License trong README chỉ ghi tên một tác giả (Peter Steinberger); không có công bố nào về một đội ngũ nhiều người duy trì danh sách tích hợp provider dài như vậy.

Tích hợp và các công cụ tương tự CodexBar

ccusage - công cụ theo dõi chi phí mã nguồn mở mà README nói rõ là nguồn cảm hứng cho phần quét chi phí sử dụng của CodexBar.Win-CodexBar - một bản port Windows riêng do cộng đồng duy trì, dành cho ai muốn ý tưởng tương tự mà không dùng Mac.codexbar-waybar và tiện ích mở rộng Codexbar GNOME - các tích hợp panel Linux bên thứ ba (Hyprland/Sway, GNOME Shell) xây trên nền CLI Linux đi kèm của CodexBar, chứ không phải một giao diện Linux gốc.codex - một trong các CLI của nhà cung cấp mà CodexBar đọc dữ liệu sử dụng trực tiếp, dành cho ai muốn dùng công cụ gốc của provider thay vì một lớp giám sát riêng.Ollama - một provider khác mà CodexBar theo dõi (API key cộng cookie trình duyệt cho khung sử dụng Ollama Cloud), đáng để so sánh với chính giao diện sử dụng của provider đó.

Câu hỏi thường gặp về CodexBar

CodexBar yêu cầu phiên bản macOS nào?

CodexBar yêu cầu macOS 14 (Sonoma) trở lên; README không liệt kê hỗ trợ cho các phiên bản macOS cũ hơn.

CodexBar có lưu API key hay mật khẩu của tôi không?

CodexBar không lưu mật khẩu. Ứng dụng dựa vào việc tái sử dụng phiên đăng nhập có sẵn - OAuth, cookie trình duyệt, device flow - còn API key bạn nhập vào sẽ được ghi vào file cấu hình cục bộ với quyền truy cập hạn chế.

CodexBar hỗ trợ những nhà cung cấp AI coding nào?

CodexBar hỗ trợ một danh sách dài các provider gồm Codex, OpenAI, Claude, Cursor, Gemini, Copilot, Grok, GroqCloud, OpenRouter, LiteLLM, AWS Bedrock và nhiều provider khác, mỗi provider có một trang docs riêng trong repo.

Có phiên bản CodexBar cho Linux hay Windows không?

CodexBar không có giao diện chính thức cho Linux hay Windows. Linux có CLI đi kèm (qua Homebrew formula cho Linux, gói AUR, hoặc tarball release) cộng các dự án cộng đồng như codexbar-waybar và một widget KDE; Windows chỉ có bản port Win-CodexBar riêng do cộng đồng duy trì.

CodexBar theo dõi những loại dữ liệu sử dụng nào?

CodexBar theo dõi khung sử dụng theo phiên, tuần và tháng của từng provider kèm đồng hồ đếm ngược reset, số dư credit, dashboard chi tiêu/chi phí ở những provider có cung cấp, và trạng thái/incident của provider.

Vì sao CodexBar cần quyền Full Disk Access hay Keychain?

Full Disk Access chỉ cần để đọc cookie/local storage của Safari cho các provider dựa trên cookie trình duyệt, còn lời nhắc Keychain xuất hiện khi CodexBar giải mã khóa "Safe Storage" của một trình duyệt nền Chromium hoặc khởi tạo OAuth cho Claude từ thông tin đăng nhập CLI đã lưu sẵn - cả hai đều có thể bỏ qua bằng cách tắt Keychain access trong Settings.

Vấn đề mà nó giải quyết

Mỗi gói AI coding có dashboard riêng, đồng hồ reset riêng, và định nghĩa "khung sử dụng" riêng - provider này tính theo phiên, provider kia tính theo tuần, provider khác lại theo tháng - nên bạn hoặc phải lưu sẵn cả chục tab trình duyệt, hoặc chỉ biết mình bị giới hạn tốc độ khi một tác vụ dài đang chạy dở thì lỗi. Cách CodexBar giải quyết là đọc trực tiếp nguồn dữ liệu sử dụng của từng provider (OAuth API, cookie trình duyệt, CLI cục bộ, file cấu hình), để các khung sử dụng và đồng hồ đếm ngược reset đó gom về một chỗ trên menu bar thay vì rải rác khắp các tab.

Trường hợp sử dụng tốt nhất

  • Chạy song song Codex và Claude, muốn xem khung sử dụng theo phiên/tuần của cả hai provider trước khi bắt đầu một tác vụ dài, thay vì chuyển qua lại giữa hai dashboard web.
  • Theo dõi chi tiêu trên nhiều provider có API (OpenAI, Claude Admin API, OpenRouter, LiteLLM, AWS Bedrock và các provider khác) qua ước tính cục bộ 7/30 ngày ở màn hình Settings -> Usage & Spend.
  • Đưa việc kiểm tra mức dùng vào CI hoặc script shell bằng CLI `codexbar` đi kèm, ví dụ `codexbar cost --provider both` để lấy cả Codex lẫn Claude trong một lệnh.
  • Nhận cảnh báo sớm khi một provider gặp sự cố qua nhãn status-polling, thay vì mất công debug một agent bị treo trong khi thực ra provider đang bị sập.
  • Chạy CLI trên Linux thông qua một widget panel của cộng đồng (Waybar, GNOME, KDE Plasma, Cinnamon) thay vì dùng ứng dụng macOS.

Ai nên dùng — và ai nên bỏ qua

Nếu bạn dùng từ hai công cụ AI coding trở lên trong ngày - chẳng hạn Codex cộng với Claude, hoặc vài provider có API - và đã chán cảnh bị cắt ngang tác vụ mà không được báo trước, CodexBar xứng đáng có một chỗ trên menu bar của bạn. Bỏ qua nếu bạn chỉ dùng đúng một provider với trang usage bạn đã quen kiểm tra, hoặc nếu máy bạn chưa lên macOS 14 trở lên: CLI cho Linux và các widget cộng đồng bên thứ ba vẫn tồn tại nhưng không có trải nghiệm hoàn thiện như bản macOS mà README mô tả.

Repo liên quan

Nguồn & ghi công

Lấy nguồn từ repository GitHub steipete/CodexBar - README, tài liệu provider và release notes.

Dữ liệu GitHub · đồng bộ lần cuối 6 thg 8, 2026Đánh giá bởi Henry
Về TopGit