このプロジェクトについて

agentacctは、ローカルファーストの「エージェント作業インテリジェンス」ツールで、「コーディングエージェントが実際に何をしているか、そのコストはいくらか」という実用的な問いに答えます。コーディングエージェントのローカルセッションログを読み取り、プロジェクトやクライアント横断で、最近のアクティビティ、ツール呼び出し、記録されたステップ、チェック、トークン、推定コストを表示します。 言及されているサポート対象クライアントには、Claude Code、Codex、Kimi Code、OpenCode、Hermesなどがあり、各機能レーンを個別に評価する文書化されたカバレッジマトリックスがあります。READMEには、Claude CodeとCodexが現在最も完全なレシートを備えていると記載されています。 インストールはpipx経由(macOSまたはLinuxでPython >= 3.11、WindowsはWSL経由のみ)で、署名付きmacOSアプリも提供されています。セットアップでは、マシンごとに一度`agentacct onboard`を実行してエージェントを検出し、ローカルストアを作成してレコーダーを起動します。`agentacct tui`でターミナルアプリが開きます。プロジェクトスコープのインストールでは、すべてをリポジトリ内に保持します。 インターフェースは、セッションビューとタスクごとの「作業レシート」を中心に構成され、参加セッション、記録された成果、推定コスト、主張、チェック結果、アクティビティタイムラインを組み合わせます。重要な区別は「報告済み」と「検証済み」です。エージェント自身の「完了」は「報告済み」に過ぎず、「検証済み」には、最後に記録された変更後に現在のチェックが合格していることが必要です。失敗した試行は履歴に残ります。 ワークグループを使用すると、プロジェクトフォルダを指定して、そこで作業したエージェント、セッション詳細、共有のクロスエージェントタイムラインを確認できます。ダッシュボードには、クライアント、時間、成果、証拠、コストを含む最新の記録済み作業が表示され、過去の失敗チェックやブロッカーはデフォルトの並び順にせず、別の「記録済み問題」領域に保持します。 使用量ビューは、日付、エージェント、モデル、プロバイダーで個別にフィルタリングでき、エージェントとモデルごとの範囲合計、Fresh/Allトークントグルのある日次チャート、キャッシュ読み取りと書き込みを分けた内訳を表示します。トークンはクライアント記録から取得され、コストは価格表ベースの推定値で≈マークが付けられ、明示的に請求書ではありません。プロバイダー報告のクォータウィンドウとリセット時間も同じページに表示されます。 ターミナルUIは、レシート、使用量、容量、レビュー概要を提供し、フォルダに固定された作業タブには、キーボードで操作可能なクロスエージェントタイムラインがあります。 このプロジェクトは、正直さとプライバシーを重視しています。推定値にはラベルが付けられ、欠落データはゼロではなくギャップとして表示され、使用量と記録済み作業のすべての結合には信頼度ラベル(正確、高、中、低)が付けられ、サポートはロゴごとではなく機能ごとに説明されます。ツール名とカテゴリ、触れたファイル、資格情報をスクラブしたコマンド、終了コード、トークン、記録されたステップなどの作業メタデータを記録しますが、プロンプト、モデル応答、トランスクリプトは記録しません。ローカルセッションファイルのみを読み取り、127.0.0.1のみでリッスンし、プロバイダーAPIキーを保存または要求することはありません。 アーキテクチャ的には、2つの証拠ストリームを分離して保持します。使用されたもの(クライアントセッションファイルから)と実行されたもの(MCP経由で記録されたステップとチェック、およびテスト実行などのマシンチェックから)で、実際のクライアントIDで結合し、信頼度にラベルを付けます。Claude Codeはインストールされたフックブリッジを介してIDをバインドし、CodexとOpenCodeはインポート時に独自のログから照合され、Hermesは明示的に渡されたIDでのみ結合します。 アンインストール手順では、管理プロセスを停止し、インストールされている場合は自動起動を削除し、パッケージをアンインストールし、オプションでローカルストアとクライアント設定エントリを削除します。ドキュメントには、リファレンス資料、カバレッジマトリックス、アーキテクチャ、安全境界、プライバシー脅威モデル、実例、完全なデモが含まれています。