agentacct: READMEの実装範囲と導入時に見るべき条件
コーディング エージェントが何をしたのか、そしてそれにどれくらいの費用がかかるのかを確認してください。各タスクを作業ステップ、使用したツール、変更されたファイル、実行したテスト、費やした時間とトークンに分割します。 Claude Code、Codex、OpenCode などのローカルファーストのダッシュボード。ログインもテレメトリもありません。
ひと目でわかる
- これは何？
- mikehasa/agentacctについて、READMEとリポジトリ情報から機能、構成、制約、導入確認点を整理する。
- 誰に向いている？
- agentacctは、READMEに記載された機能と前提が自分の用途に重なる場合に、検証用環境から評価を始められるプロジェクトです。pipxでagentacctを入れ、onboard後に既存セッションログをコピーした検証用ディレクトリへ向ける。
- 商用利用できる？
- できます。MIT は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
- 今もメンテナンスされている？
- されています。最後のコミットは 2 日前です。
- 何の言語で書かれている？
- 主に Python です（GitHub の言語統計による）。
回答はプロジェクトの GitHub データ（最終同期：2026年9月14日）と当サイトの分析に基づくもので、法的助言ではありません。
オープンソース詳細解説
agentacctを読むための焦点
agentacct は、Claude Code と Codex がすでにマシンに書き込むセッションログを読み取り、各セッションが記録する作業と結合し、`agentacct tui`（ライブ端末ダッシュボード）で結果を表示します。ブラウザ不要、サーバー不要、アカウント不要。すべてがマシン上に留まります。状態はプレーンなローカルファイルで、ネットワークポートをバインドせず、電話ホームテレメトリもアカウントもクラウド同期もありません。agentacct はプロバイダーの API キーを保存または要求しません。
pipxでagentacctを入れ、onboard後に既存セッションログをコピーした検証用ディレクトリへ向ける。端末ダッシュボードの使用量、作業ステップ、帰属ラベルがログのどの行から計算されたかを突き合わせ、アルファ版の推定値を請求額の確定値として扱わない。 第1章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。
使用量、作業ステップ、帰属ラベル
TUI は使用ウィンドウ、プロバイダーのレート制限バー（リセットカウントダウン付き）、最近のセッションを表示します。`s` を押すとセッションにドリルダウンし、`u` で使用画面、`p` で共有可能な SVG スナップショットを保存します。エージェント、モデル、日ごとのトークンはクライアント自身のローカルセッションファイルから読み取られ、`client_reported` とラベル付けされます。コストは価格表の推定値であり、請求書ではありません。各セッションは、記録された作業ステップとマシンチェックを集約し、`in progress`、`handed off`、`done`、`blocked` などのステータスと、終了コード付きのチェック結果を表示します。使用量と作業の間の帰属には、exact、high、medium、low の信頼度ラベルが付きます。agentacct がリンクを証明できない場合、推測ではなくギャップを表示します。
pipxでagentacctを入れ、onboard後に既存セッションログをコピーした検証用ディレクトリへ向ける。端末ダッシュボードの使用量、作業ステップ、帰属ラベルがログのどの行から計算されたかを突き合わせ、アルファ版の推定値を請求額の確定値として扱わない。 第2章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。
使用の真実と作業の意味は結合されるまで分離される
agentacct は 2 つの証拠ストリームを分離し、実際のクライアント ID で結合します。使用の真実はクライアント自身のローカルセッションファイルから来て、`client_reported` とラベル付けされます。作業の意味は、エージェントが作業中に MCP を介して記録するセクションとイベント、`agentacct_record_section` と `agentacct_record_machine_check`、およびテスト実行のようなマシンチェックから来ます。結合はセッション/トランスクリプト ID を通じて 2 つをリンクし、各帰属を exact、high、medium、low とラベル付けします。Claude Code の場合、インストールされたフックブリッジがセッション開始時とすべてのツール呼び出し時に実際のセッション/トランスクリプト ID をキャプチャします。Codex の場合、リンクはインポート時にクライアント自身のセッションログから証明されます。詳細は docs/reference.md にあります。
pipxでagentacctを入れ、onboard後に既存セッションログをコピーした検証用ディレクトリへ向ける。端末ダッシュボードの使用量、作業ステップ、帰属ラベルがログのどの行から計算されたかを突き合わせ、アルファ版の推定値を請求額の確定値として扱わない。 第3章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。
pipx でインストールして onboard を実行
macOS または Linux で Python >= 3.11 が必要で、Windows は WSL 経由のみサポートされます。`pipx install agentacct` でインストールし、マシンごとに `agentacct onboard` を 1 回実行します。onboard はローカルのコーディングエージェントログを検出し、グローバルストアを設定し、最初の使用同期を実行し、オプションで http://127.0.0.1:8765 でブラウザダッシュボードを起動します。onboarding 後、新しいエージェントセッションを開く必要があります。MCP サーバーとフックはセッション開始時にバインドされるため、onboarding セッションは最初の記録タスクにはなれません。リポジトリごとのインストールには `agentacct onboard --scope project` を使用します。`agentacct demo` は使い捨てストアで安全なローカルウォークスルーを実行します。管理ランタイムは `agentacct start`、`status`、`stop`、`repair` で制御されます。
pipxでagentacctを入れ、onboard後に既存セッションログをコピーした検証用ディレクトリへ向ける。端末ダッシュボードの使用量、作業ステップ、帰属ラベルがログのどの行から計算されたかを突き合わせ、アルファ版の推定値を請求額の確定値として扱わない。 第4章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。
誠実さの制限とラベル付きの推定
agentacct は初期アルファ版であり、推測ではなくギャップを表示することを好みます。ホスト型ダッシュボードも、電話ホームテレメトリも、自動クラウドアカウント同期もありません。OTLP エクスポーターを明示的に向けると、ローカルでテレメトリを受信できます。コストはローカル価格表からの推定値であり、請求書ではありません。検出されたクライアントのローカルセッションファイルのみを読み取り、agentacct/integrations の外で開始された無関係なプロセスを監視しません。ハードストップは、agentacct 自身が起動した実行またはオプトインのプロキシパスにのみ適用されます。サポートはロゴごとではなく、能力ごとです。Claude Code と Codex には今日、ライブで観察された使用パスがあります。他のクライアント（Hermes、OpenCode、OpenClaw、Cursor）には、より狭く明示的にスコープされたパスがあります。毎週の Claude プラン推定はベータ版で、記録された制限履歴からアカウントにキャリブレーションできる場合にのみ数値を表示します。
pipxでagentacctを入れ、onboard後に既存セッションログをコピーした検証用ディレクトリへ向ける。端末ダッシュボードの使用量、作業ステップ、帰属ラベルがログのどの行から計算されたかを突き合わせ、アルファ版の推定値を請求額の確定値として扱わない。 第5章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。
アルファステータス、ドキュメント、貢献
agentacct がアルファの間、インターフェースは変更される可能性があります。リポジトリには広範なドキュメントが含まれています：リファレンス、インストールランブック、使用量とコストの真実の表、コーディングエージェント統合、アーキテクチャ、プライバシー脅威モデル、安全境界、完全なデモ、ライブスモーク証拠、パブリックアルファチェックリスト。開発は CONTRIBUTING.md で説明されています。クローンから pytest でテストを実行します。pipx インストールにはテストツールは付属していません。フィードバックのリクエストには、使用しているエージェント、遭遇した暴走またはコストの問題、間違って見えた結合、次にサポートすべき統合が含まれます。問題を開き、共有する前にログから API キーを消去してください。
pipxでagentacctを入れ、onboard後に既存セッションログをコピーした検証用ディレクトリへ向ける。端末ダッシュボードの使用量、作業ステップ、帰属ラベルがログのどの行から計算されたかを突き合わせ、アルファ版の推定値を請求額の確定値として扱わない。 第6章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。
編集部の結論
agentacctは、READMEに記載された機能と前提が自分の用途に重なる場合に、検証用環境から評価を始められるプロジェクトです。pipxでagentacctを入れ、onboard後に既存セッションログをコピーした検証用ディレクトリへ向ける。端末ダッシュボードの使用量、作業ステップ、帰属ラベルがログのどの行から計算されたかを突き合わせ、アルファ版の推定値を請求額の確定値として扱わない。 本番採用に向くかは、ここで確認した入力、出力、権限、ライセンスの条件が運用要件を満たすかで判断します。
コミュニティノート