🔧 Công cụ lập trình•Mã nguồn mở•Beta

agentacct

TUI local-first theo dõi token, chi phí ước tính và bằng chứng công việc của Claude Code, Codex cùng các coding agent khác.

#agentacct

Truy cập website Xem GitHub ⚖️ So sánh

Danh mục

🔧 Công cụ lập trình

Giá

Mã nguồn mở

GitHub Stars

⭐ 736

Ngôn ngữ

Python

License

MIT

Ngày thêm

2026-08-05

agent-observability cost-tracking coding-agents claude-code codex tui local-first open-source

Tóm tắt từ README GitHub

agentacct English · 简体中文 agentacct answers one simple question: what the fuck are my agents actually doing? Your coding agent says it is done. agentacct shows you what it actually did, what it cost, and how much of that is proven: one Work Receipt per task, built from the session logs your coding agents (Claude Code, Codex, OpenCode, Hermes, and others) already write on your machine. No account, no cloud, nothing leaves your computer. Screenshots show a synthetic demo workspace; your install renders your own local data. Install Requires Python >= 3.11 on macOS or Linux; Windows is supported only via WSL. For a native window with no Python, download the signed, notarized macOS app from the latest release (macOS 14+). Either way, open a new agent session afterwards: hooks and MCP servers bind at session start. The per-agent setup, a install, and the / alternatives are in INSTALL.md. Done, according to whom? The receipt above answers three questions in order: did it finish, who says so, and is the proof still current. The agent's own "done" files under Reported . A task reads Verified only when every current check passes and ran after the last recorded change. A step with n

Xem thêm từ README.md

Đánh giá chi tiết

Tổng quan

agentacct là dashboard terminal local-first để trả lời hai câu hỏi thường bị tách rời: coding agent đã tốn bao nhiêu token/tiền, và nó thực sự làm được gì. Công cụ đọc session log mà Claude Code, Codex và các client đã ghi trên máy, rồi ghép chúng với work ledger gồm bước thực hiện, file thay đổi, test và trạng thái. Không cần tài khoản, server, telemetry hoặc API key của provider.

Điểm khác biệt là agentacct không coi mọi dữ liệu có độ tin cậy như nhau. Token được gắn nhãn client_reported, chi phí là ước tính theo bảng giá chứ không phải hóa đơn. Một test có exit code 0 được đánh dấu Verified; tuyên bố do agent tự viết vẫn là Agent reported. Việc nối session với work item cũng có confidence exact/high/medium/low, và công cụ chấp nhận để trống hơn là ghép sai.

Tính năng chính

TUI theo dõi usage window, rate-limit reset, token và chi phí theo ngày/model/agent.
Danh sách session với bước làm việc, tool, file, test và trạng thái blocked/done.
Xuất snapshot SVG để chia sẻ.
Import log cục bộ; không bind network port.
Hook/MCP tùy chọn để agent ghi work ledger có cấu trúc.
Chẩn đoán attribution và sửa state mà không che giấu khoảng trống dữ liệu.

Điểm mạnh

agentacct giải quyết một nhu cầu thực tế mà nhiều dashboard chỉ đếm token bỏ qua: chi phí phải gắn với kết quả và mức bằng chứng. Release v0.8.1 còn sửa lỗi nguy hiểm về mặt báo cáo: một file Claude Code không đọc được từng khiến cả nguồn dữ liệu bị coi là incomplete rồi hiển thị $0. Bản mới cô lập lỗi theo file và cảnh báo thay vì đưa ra con số 0 tự tin.

Tôi chạy test bằng Python 3.11: 3.067 test pass, 1 skip. Source tree vẫn sạch sau khi khôi phục thay đổi lockfile do môi trường uv cập nhật package version nội bộ. Bộ test rất rộng là tín hiệu tích cực, nhưng không thay thế so sánh với hóa đơn provider hoặc mọi phiên bản client ngoài thực tế.

Hạn chế

Dự án tự ghi rõ đang ở early alpha; schema và interface có thể đổi. Chi phí là phép tính từ usage + pricing table, không phải số tiền cuối cùng sau credit, subscription hoặc chính sách nhà cung cấp. Codex cũng không luôn cung cấp cùng loại weekly meter như Claude.

Cài hook hoặc MCP có thể chỉnh file cấu hình của agent như .claude.json, settings và config.toml. Tài liệu có hướng dẫn gỡ, nhưng người dùng vẫn nên backup config. uv.lock tại commit kiểm tra còn ghi version package nội bộ 0.6.0 trong khi pyproject.toml là 0.8.1; uv run đã cập nhật dòng này cục bộ, cho thấy lockfile metadata chưa hoàn toàn đồng bộ dù test vẫn pass.

Phù hợp khi nào

agentacct hợp với developer hoặc team chạy nhiều phiên Claude Code/Codex và muốn hiểu token nào tạo ra test, diff hay kết quả cụ thể. Nó không phải hệ thống billing chính thức hoặc SIEM. Dùng tốt nhất như lớp quan sát cục bộ, sau đó đối chiếu định kỳ với số liệu provider.