mikehasa/agentacct:README に基づく導入ガイド
README、メタデータ、ライセンスに基づく mikehasa/agentacct の導入と確認ガイドです。
プロジェクトの範囲
mikehasa/agentacct の README はプロジェクトを「See what your coding agents did and what it cost. Breaks each task down into work steps , tools used, files changed, tests run, time and tokens spent. Local-first dashboard for Claude Code, Codex, OpenCode, and more. No login, no telemetry.」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「agentacct」には次の説明があります。See what your coding agents actually did , and what it cost , in a live terminal dashboard that never leaves your machine.。これは範囲の説明であり、本番検証の結果ではありません。
向いている用途
README の「What you get」にある内容から、用途が合うかを先に判断できます。The work, not just the tokens. Every session rolls up its recorded work steps and machine checks , a passing test is Verified evidence, an agent's own claim stays labeled Agent reported.。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。Honest usage and cost. Tokens per agent, model, and day , read from the clients' own local session files and labeled clientreported; costs are clearly marked pricing-table estimates, never invoices.。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。
動作の考え方
動作の説明は「agentacct」など複数の箇所に分かれています。確認できる情報は次の通りです。Private by design. Everything stays on your machine: state is plain local files, nothing binds a network port, and there is no phone-home telemetry, no account, no cloud sync. agentacct never stores or requests a provider API key.。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。
インストールと初回起動
初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 Install and set up agentacct , 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` (installs once per machine, global by default, zero files written into the repo), then tell me the dashboard URL. Observe-only: never store, request, or echo any API key; all state stays local on this machine. Don't modify my global client confi 実行可能なコマンドがない場合は手順を作らず、「What you get」で依存関係、待受ポート、初回設定を確認します。