abtop: Giám sát AI Agent bằng TUI
/abtop
abtop đáng cài đặt khi bạn chạy từ hai AI coding agent trở lên. Muốn biết project nào đang ngốn token hoặc session nào để server chạy trên port 5173, đây là công cụ phù hợp. Chỉ dùng một agent thôi thì htop đã đủ.
abtop là gì?
abtop là dashboard trên terminal phát hiện và hiển thị mọi phiên Claude Code, Codex CLI và OpenCode đang chạy trên máy. Mỗi phiên hiển thị token usage, phần trăm context window đã dùng, rate limits, tiến trình con và cổng đang nghe trong một TUI chỉ đọc. Không cần API key hay xác thực, chỉ đọc trạng thái tiến trình và file config cục bộ.
Tính năng chính của abtop
- ✓Theo dõi token usage và phần trăm context window cho mỗi phiên, kèm cảnh báo khi context gần đầy. Thanh fill % cho biết khi nào Claude Code bắt đầu nén bộ nhớ.
- ✓Giám sát API rate limit cho Claude Code và Codex CLI, cho phép theo dõi quota tiêu thụ thời gian thực và tạm dừng trước khi chạm trần.
- ✓Phát hiện cây tiến trình con và orphan port — nhận ra ngay dev server mà agent quên tắt, giúp dọn dẹp nhanh.
- ✓Tự động khám phá multi-session trên macOS, Linux và Windows bằng cách đọc trạng thái tiến trình và config cục bộ.
- ✓12 themes có sẵn, trong đó 4 theme dành cho người mù màu và 2 theme light.
- ✓Chế độ snapshot JSON cho scripting, kèm theo Rust library crate để nhúng vào ứng dụng Rust khác.
- ✓Nhảy sang terminal của session qua phím Enter, hỗ trợ tmux pane, iTerm2 trên macOS và cmux.
abtop hữu ích trong trường hợp nào
- •Chạy ba agents cùng lúc qua các project riêng biệt — xem token burn rate và context % cạnh nhau trên một màn hình.
- •Gặp rate limit bất ngờ — theo dõi quota tiêu thụ trực tiếp để kịp tạm dừng trước khi chạm trần.
- •Agent khởi tạo dev server trên port ngẫu nhiên rồi không dọn dẹp — phát hiện orphan port cho thấy ngay.
- •Cần chuyển giữa các agent terminal mà không mất vị trí — Enter nhảy đến tmux pane hoặc iTerm2 tab tương ứng.
- •Debugging tại sao Claude Code đang thiếu context — thanh fill % với compaction detection cho biết khi nào nó đang nén bộ nhớ.
Cài đặt abtop
Trên macOS hoặc Linux, chạy script cài đặt chính thức: curl --proto '=https' --tlsv1.2 -LsSf https://github.com/graykode/abtop/releases/latest/download/abtop-installer.sh | sh Trên Windows, mở PowerShell và chạy: powershell -c "irm https://github.com/graykode/abtop/releases/latest/download/abtop-installer.ps1 | iex" Cả hai đều cài binary không phụ thuộc runtime. Trên Linux, sqlite3 bắt buộc để giám sát OpenCode. Trên Windows, sqlite3 tùy chọn nhưng cần cho OpenCode. Binary có sẵn cho mọi nền tảng trên trang Releases, và cargo install abtop cũng hoạt động nếu đã có Rust toolchain.
Sử dụng TUI abtop
Chạy abtop không đối số để mở TUI tương tác. Dùng phím mũi tên hoặc k/j để chọn phiên, Enter để nhảy sang terminal, t để chuyển theme, Esc để mở overlay cấu hình. Nhấn q để thoát. Cho script, abtop --once xuất snapshot ra stdout rồi thoát. abtop --json cũng xuất một snapshot JSON rồi thoát. Chạy abtop --setup một lần để cài hook thu thập rate limit. Kích thước terminal khuyến nghị là 120x40; abtop hoạt động xuống 80x24 nhưng ẩn các panel khi không gian hẹp. Mouse capture tắt mặc định — dùng --mouse nếu muốn click và cuộn.
Điểm mạnh
- ✓Giám sát nhiều AI coding agent cùng lúc trên một terminal — không cần chuyển tab.
- ✓Không cần API key hay xác thực, hoạt động hoàn toàn offline bằng cách đọc trạng thái cục bộ.
- ✓TUI viết bằng Ratatui với 12 theme, trong đó 4 theme dành cho người mù màu.
- ✓Chạy được trên macOS, Linux và Windows với binary gốc cho từng nền tảng.
- ✓Chế độ snapshot JSON và Rust library API cho phép tích hợp dữ liệu abtop vào dashboard tùy chỉnh.
- ✓Phát hiện orphan port giúp nhận ra ngay server mà agent bỏ lại phía sau.
Những gì abtop không làm được
- △Giám sát OpenCode cần sqlite3 trong PATH — không có thì abtop chỉ hiển thị cảnh báo một lần và agent đó không xuất hiện trên giao diện. Linux cũng cần dependency này.
- △Theo dõi rate limit chỉ hoạt động cho Claude Code và Codex CLI. OpenCode không có panel rate limit nào, dù bạn đang tiêu tốn quota.
- △Phần trăm context window và hiển thị task hiện tại không có cho OpenCode, khiến thiếu hai tín hiệu quan trọng nhất để quản lý trạng thái agent đó.
- △Windows báo LOAD luôn là 0 vì nền tảng này không có load average — mất tín hiệu đó so với macOS và Linux.
- △Struct App không phải Send-safe, nên consumer dùng như thư viện phải giữ mọi collector trên một thread duy nhất; muốn chuyển dữ liệu sang thread khác phải serialize thành JSON trước.
Thay thế cho abtop
Câu hỏi thường gặp
Không. abtop hoạt động hoàn toàn chỉ đọc, chỉ đọc trạng thái tiến trình, file config và database SQLite trên máy. Không API key, không auth, không cần tài khoản.
Claude Code, Codex CLI và OpenCode. Độ sâu hỗ trợ khác nhau — Claude Code nhận được nhiều metrics nhất, OpenCode bị giới hạn hơn nhiều.
abtop đọc trạng thái tiến trình và file config cục bộ. Với Claude Code, nó kiểm tra ~/.claude và thư mục config tùy chỉnh; với OpenCode, nó đọc SQLite database cục bộ. Không quét mạng hay probe gì cả.
Có, hỗ trợ Windows gốc. Dùng sysinfo cho thông tin tiến trình và netstat -ano cho cổng. Không cần WSL. Hỗ trợ OpenCode cần sqlite3 CLI.
80x24 vẫn hoạt động nhưng các panel ẩn đi khi không gian nhỏ. Kích thước 120x40 được khuyến nghị để hiển thị đầy đủ mọi thứ.
Có. Thêm abtop như một crate, tạo instance App, gọi tick_no_summaries để refresh mà không chạm vào Claude quota, rồi serialize bằng App::to_snapshot.
Ai nên thử — và ai nên bỏ qua
Nên thử abtop nếu chạy nhiều AI coding agent qua các project và muốn theo dõi chi phí token, áp lực context, cũng như server được spawn. Đặc biệt hữu ích cho team cần kiểm soát budget hoặc debug quota hit bất ngờ. Bỏ qua nếu chỉ chạy một agent trong một terminal — htop đã đủ việc, và abtop chưa xứng đáng chỗ trong workflow cho đến khi bạn cần quản lý nhiều phiên cùng lúc.
Repo liên quan
Chưa chắc abtop có hợp với bạn?
Để ChatGPT, Claude hoặc Perplexity tìm hiểu giúp — bấm bên dưới và xem AI nói gì về abtop.