agentacct 是一个本地优先的仪表盘,能读取编码助手的会话日志,展示 token 用量、估算成本、任务及证据,所有数据均不离开你的机器。

Stars

347

7 天增长

暂无数据

Fork 数

2

开放 Issue

0

开源协议

MIT

最近更新

2026-07-25

为什么值得关注

它将会话使用数据与记录的工作相连接,为每条归因标注置信度,从不回传数据或要求 API 密钥,提供了诚实且保护隐私的编码助手可观测性。

适合谁使用

  • 使用 Claude Code 或 Codex 的开发者
  • 管理助手成本和产出的工程团队
  • 追求助手透明度的开源维护者
  • 评估助手可问责性的平台工程师

典型使用场景

  • 监控每个助手的 token 消耗和估算成本
  • 审查带有工作步骤和验证证据的任务
  • 审计使用数据与工作日志之间的归因质量
  • 无需云依赖即可比较不同会话的助手表现

项目优势

  • 隐私优先:所有数据保留在本地
  • 诚实标注:成本明确标为估算值,归因缺口直接展示
  • 支持多种编码助手,并配有按能力划分的矩阵
  • 开源且可扩展,附有详细参考和架构文档

使用前须知

  • 早期 alpha 版本:接口可能变化;仅 Claude Code 和 Codex 有完整使用路径
  • 需要 Python ≥3.11 且仅支持 macOS/Linux;Windows 仅通过 WSL
  • 无云同步或托管仪表盘;所有状态为本地文件

README 快速开始

agentacct

See what your coding agents actually did — and what it cost — on a dashboard that never leaves your machine.

agentacct is local-first Agent Work Intelligence for coding agents. It reads the session logs that Claude Code and Codex already write on your machine, joins them with the work each session records as it goes, and shows the result — tokens, estimated cost, tasks, and evidence — on a local dashboard.

Private by design. Everything stays on your machine: state is plain local files, the dashboard binds to 127.0.0.1, and there is no phone-home telemetry, no account, no cloud sync. agentacct never stores or requests a provider API key.

Screenshots show a synthetic demo workspace; your dashboard renders your machine's real local data.

What you get

  • Honest usage and cost. Tokens per agent, model, and day — read from the clients' own local session files and labeled client_reported; costs are clearly marked pricing-table estimates, never invoices.
  • The work, not just the tokens. Sessions roll up into Tasks with recorded work steps and machine checks: a passing test is Verified evidence, an agent's own claim stays labeled Agent reported.
  • Attribution you can trust. Every join between usage and recorded work carries a confidence label (exact/high/medium/low). Missing attribution beats wrong attribution: when agentacct cannot prove a link, it shows the gap instead of a guess.

Install

Requires Python >= 3.11 on macOS or Linux; Windows is supported only via WSL.

pipx install agentacct
agentacct onboard   # from your repo root

onboard detects your local coding-agent logs, sets up the project-local store, runs a first usage sync, and starts the dashboard at http://127.0.0.1:8765. Then open a new agent session in the project — MCP servers and hooks bind at session start, so the session that ran onboarding cannot become the first recorded Task.

Prefer to let the agent do it? Paste this into the coding agent working in your target repo:

Install and set up agentacct in this repo — a local-first dashboard that reads my
coding-agent logs read-only and shows honest token usage and cost.

Run `pipx install agentacct`
(or `pipx install git+https://github.com/mikehasa/agentacct`),
then `agentacct onboard` from this repo root, then tell me the dashboard URL.

Observe-only: never

项目描述

Local-first Agent Work Intelligence for coding agents: usage truth, recorded work, and honest joins. Read-only over coding-agent logs; zero-JavaScript localhost dashboard.

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

lopopolo
精选
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI 与机器学习AI 智能体
2,320
xai-org
精选
xai-org GitHub avatar

grok-build

Grok Build is SpaceXAI's terminal-based AI coding agent that runs as a full-screen TUI, understands codebases, edits files, executes commands, searches the web, and manages tasks interactively or headlessly.

AI 与机器学习AI 智能体
20,399
Jakubantalik
精选
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI 与机器学习AI 智能体
1,064