AgentsViewは、複数のツールにあるコーディングエージェントのセッションログを、検索可能な1つのローカルアーカイブにまとめられます。このガイドは、既知の作業を1つ見つけ、エージェントが実際に記録した利用量の項目を調べ、各費用の数字の出所を確認したいエンジニアリング責任者向けです。
これは、2026年10月9日のAgentsView v0.45.0リリースと現在のクイックスタートおよびトークン利用量ガイドの文書に基づく手順です。文書は10月17日に確認しました。BIG CHANGEはAgentsViewのインストール、会話記録の取り込み、これらの手順の実地テストを行っていません。文書やリリース一覧は変わり得るため、インストールするバージョンを確認してください。
始める前に
読む権限のある完了済みのコーディングエージェントのセッション、その作業に固有の語句またはセッションID、ローカルログディレクトリの読み取り権限が必要です。Quick StartにはmacOS、Windows、Linux向けのデスクトップ版ダウンロードと、Linux x86_64およびaarch64、macOS x86_64およびarm64、Windows x86_64およびarm64向けのCLI wheelが掲載されています。デスクトップアプリはパッケージ済みで、ソースからのビルドにはGo、Node、CGOの別途要件があります。クイックスタートによると、基本的なローカルアーカイブにホスト型サービスのアカウントやAPIキーは不要です。
セッションログにはプロンプト、ソースコード、ツール入力、秘密情報が含まれ得ます。チームが調査を許可したディレクトリだけを選んでください。アーカイブが取り込んでよいプロバイダーとルートを決めるのは、最初の起動前です。単に agentsview serve を実行すると、既定で対応するソースを直ちに検出して同期します。この作業ではウェブUIを文書にあるループバックアドレスのままにします。この問いに答えるためだけに、ホスト型の生データ同期、PostgreSQLやClickHouseへの送信、Gistへの公開、生成インサイト、ホスト型の埋め込みエンドポイントを有効にしないでください。意味検索は任意で、通常の全文検索はローカルインデックスで動作します。
1. インストールして実行ファイルを確認する
次のインストールガイドから方法を1つ選びます。単独CLI向けに文書化されたPythonによる常設インストールは次のとおりです。
pip install agentsview
agentsview --versionガイドには、uvx agentsview で常設せずに実行する方法、プラットフォーム別インストーラー、デスクトップパッケージもあります。macOSではHomebrew caskがアプリ同梱のCLIをリンクします。DMGから導入したアプリでは、CLIディレクトリを PATH に追加する必要がある場合があります。バージョン表示を信頼する前に、シェルが見つける実行ファイルを確かめます。GitHubは v0.45.0 を10月9日のリリースとしていますが、画面やレポートの構造を読み取るときは、自分の環境で得た --version の結果を使ってください。
2. 最初の同期前にソースを制限する
ホスト上のCLIまたはデスクトップ版を使う場合、新しいデータディレクトリとその config.toml を先に用意してからAgentsViewを起動します。設定ガイドでは、disabled_agents でローカルファイルシステムのプロバイダーを除外し、[agents.<id>].dirs で1つのプロバイダーの既定のルートを置き換える方法を説明しています。それ以外の全プロバイダーIDを同ガイドのSession Discovery表から拾い、disabled_agents に列挙し、許可された唯一のプロバイダーの dirs を承認済みルートに設定します。たとえば、[agents.codex] と dirs = ["/approved/codex/sessions"] を使うとCodexの既定ディレクトリが置き換わります。自分のシステムに合わせてパスを変更してください。除外リストが完全でなければ、ホストのデーモンをまだ起動しないでください。CODEX_SESSIONS_DIR または CLAUDE_PROJECTS_DIR のどちらか1つを上書きしても、そのプロバイダーのルートが変わるだけで、ほかのプロバイダーは既定の方法で検出され得ます。
既存アーカイブに無関係なセッションが入っている可能性があれば、この監査には新しい AGENTSVIEW_DATA_DIR を使います。設定ガイドによると、無効化したプロバイダーの過去に保存済みのセッションは残るため、設定変更で古いアーカイブが消えるわけではありません。また、disabled_agents が対象とするのはローカルでの検出と監視であり、リモートのインポートやエクスポートではありません。このローカル作業では、リモートホストやエクスポート先を設定しないでください。
ほかの全プロバイダーの除外リストを管理するのが現実的でなければ、隔離したコンテナが代替手段です。Quick StartのDocker例はUIを 127.0.0.1 だけで公開し、1つのエージェントソースを読み取り専用でマウントして、別のデータボリュームを使います。承認されたソースのルートだけをマウントし、新しいコンテナ内で対応するディレクトリ変数を設定します。プロジェクトのCompose例にあるほかのマウントは省きます。コンテナから見えるのは、明示的にマウントしたホストのセッションディレクトリだけです。公開DockerイメージはLinux amd64とarm64向けで、この方法には動作するDocker環境が必要です。
3. ローカルアーカイブを作る
ソースを制限したホストCLIでは、文書にあるフォアグラウンドサーバーを起動します。
agentsview serve手順2でソースの範囲を適用して確認した後、この操作は ~/.agentsview/sessions.db または選んだデータディレクトリを初期化し、有効なエージェントのログを検出・同期して変更を監視し、http://127.0.0.1:8080 を開きます。そのターミナルは開いたままにしてください。バックグラウンド処理を使いたければ、agentsview daemon start と agentsview daemon status を使います。デスクトップアプリは独自のバックエンドを管理します。互換性のあるサーバーが既に動作していればURLを返すだけのこともあるため、新しい設定が取り込みを制御したと考える前に、稼働中のデーモンがないか確認します。
隔離したコンテナを選んだ場合は、唯一の読み取り専用ソースマウントと新しいデータボリュームを確認してから、文書のDockerコマンドで起動します。そのループバックUIを使い、後で実行する agentsview CLIレポートも同じコンテナ内で実行し、同じアーカイブを読ませます。同時にホストでソース範囲を制限していない serve を動かさないでください。
既知の作業のソースが現れ、意図しないプロバイダーが現れないことを確かめます。セッションが見つからなければ、存在しないと結論づける前に、承認済みパス、プロバイダー設定、同期状態を調べます。レポートの前に最近変更されたファイルを反映する必要があれば agentsview sync を実行します。サーバーも変更を監視します。完全な再同期の前には、設定された範囲を再確認してください。
4. 作業を探して会話記録を検証する
ウェブUIで Ctrl/Cmd+K を使い、既知の作業に固有の語句を文字どおり検索します。プロジェクト、エージェント、日付で一覧を絞り、候補を開いてメッセージとツール呼び出しを確認します。完全なセッションIDまたはUUIDが分かっていれば、Ctrl/Cmd+G で直接開けます。これらの操作は Quick Startに記載されています。利用量の結果を正しい会話に結び付けるため、エージェント、セッションID、日付を記録します。
文字どおりの検索で作業が見つからなければ、短い語句で試し、元のエージェントがAgentsViewから読めるディレクトリにローカル会話記録を書いたか確認します。リモートサービスだけ、非対応の形式、設定されたルート外のディレクトリにある作業は、検索を重ねても取り戻せません。ローカルソースがないときの定番の対処として、意味検索用のインデックス作成や会話記録のアップロードを有効にしないでください。
5. セッションの利用量項目を確認する
見つかったセッションの利用量表示を開き、記録済みのモデル、入力、出力、キャッシュ作成、キャッシュ読み取りのうち、存在する項目を確認します。トークン利用量ガイドは費用レポートを実験的で、まだ発展途上としています。AgentsViewはソースログからモデルとトークンのメタデータを取り込み、メッセージ行に元のトークン利用量を保持します。ソースが明示した費用があればそれを使い、なければ利用可能なトークンとモデル料金から費用を計算します。JSONの出所表示では、それぞれ reported、computed、または mixed と呼びます。
その1セッションについて機械可読な記録を残したければ、プロジェクトのCLI例では agentsview session usage SESSION_ID --format json を使っています。SESSION_ID を会話記録で確認したIDに置き換え、JSONを作業メモと一緒に保存します。合計を引用する前に、この出力のモデル、トークン区分、費用の出所を確認してください。
空欄やモデルの欠落は不明として扱います。AgentsViewはエージェントが記録しなかった利用量を再構成できません。リリースノートによると、Junie CLIの取り込みではIDE内だけの会話とツール呼び出しは除かれ、Antigravityのプレーンテキスト代替経路には会話内容はあってもトークン利用量や費用がありません。検索可能なセッションに完全な支出額があるとは限らない具体例です。ソースが報告する金額がセッション全体の合計を示していても、モデル別の配分は推計のままという場合があります。
6. 日次レポートの範囲を絞る
Usageページの日付、プロジェクト、エージェントのフィルターを使い、セッションがあった日を確認します。このページには、個々の会話記録へリンクするTop Sessions by Cost表もあります。監査可能なターミナルレポートを得るには、次のコマンドにセッションの現地日付とエージェント名を入れます。
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown日次表はキャッシュされていない入力、出力、キャッシュ作成、キャッシュ読み取りを分け、--breakdown を設定するとモデル別の行を表示します。--timezone を指定しなければ、日付はシステムのタイムゾーンでまとめられます。1日の合計には同じエージェントのほかのセッションが含まれ得るため、範囲と規模の確認用であり、その1作業の費用ではありません。日次レポートとともにセッションIDを残し、実際にどの行がそのセッションに属するか確認します。
価格カタログを取得せずにレポートを出すには、--offline を加えます。AgentsViewによると、これはソース同期やデーモン起動をせず既存アーカイブを読み、組み込みの代替価格を使います。最近のセッション変更が重要なら、先にアーカイブを更新してください。オフラインのレポートは新しいログを検出できません。通常の利用量コマンドはLiteLLMやOpenRouterの価格を取得する場合があり、組み込みカタログはインストールしたリリースとともに古くなります。
7. 数字を解釈してサービスを止める
各数字に出所を示すラベルを付けます。Computed は、AgentsViewが記録済みトークンに選択した料金を掛けたことを意味します。Reported は、ソースが明示的な費用を提供したことを意味します。Mixed は、複数の種類を合わせたレポートです。ソース報告の数字であっても、アカウント全体のプロバイダー請求書が照合済みである証拠ではありません。特にサービス階層、割引、サブスクリプションの利用枠が重要なら、そのプロバイダー自身の請求・プラン記録を別途照合します。AgentsViewの文書では、保存済み利用量に該当階層がなければ、Batch、Flex、Priority、地域別、1時間キャッシュの料金を推定できないとしています。ツール側の一部トークンはローカル会話記録にありません。
成功の確認は、エージェント、ID、日付が選んだ利用量表示と一致する会話記録が見つかり、存在するモデル・トークン項目を記録し、取得できない項目を不明と記した状態です。得られるのは検索可能なローカルアーカイブと範囲を絞った作業・日次の利用量メモであり、請求書ではありません。フォアグラウンドの agentsview serve は Ctrl+C で止め、バックグラウンドサーバーは agentsview daemon stop で止めます。Quick Startによると、デーモンを停止するとウェブUIとセッション監視の両方が止まります。
大きな変化
ローカル会話記録は、費用の議論に追跡可能な出発点を与えます。エンジニアリング責任者は、数字を特定の記録済み作業にさかのぼり、エージェント由来なのか価格カタログ由来なのか確認できます。ログが不完全な部分は、レポートでも欠落として残すべきです。
出典と参考資料
- AgentsView v0.45.0リリースノート：エージェント対応範囲、Usageカード、同期、価格処理に関する日付付きの変更。リリースノートはベンダーの記録であり、BIG CHANGEの実地テストではありません。
- AgentsView Quick Start：対応するインストール方法、サーバーとデーモンのコマンド、ソース設定、ローカル検索操作。
- AgentsView設定：ソースの検出、プロバイダーの除外、アーカイブの場所、それらの制御の限界。
- AgentsViewのトークン利用量と費用：ソース対応範囲、利用量レポート、価格の出所、オフラインモード、既知の報告上の制約。
- AgentsViewリポジトリ：ソースコードとMITライセンス。リポジトリは既定アーカイブをローカルと説明しています。
