Superbased Observer について
Superbased Observer はローカルのセッションログから、AI コーディングエージェントのコストとトークン使用量を追跡し、任意のプロキシでプロバイダー報告値も記録します。使用量や予算を管理する開発者向けで、ダッシュボード、CLI、任意の MCP クエリはローカルで動作します。
主な機能
- 01エージェント、モデル、セッション、プロジェクト別のコスト
- 02任意のプロキシによるトークンとキャッシュの計測
- 03ローカルのダッシュボード、ウォッチャー、CLI
- 04使用上限、コスト予測、無駄の検出
- 05ガードレールとエージェント間のセッション引き継ぎ
活用シーン
- 01プロジェクト間でコーディングエージェントの費用を比較
- 02キャッシュ使用量とコスト上限の接近状況を確認
- 03MCP 経由でエージェントから過去のセッションを照会
MCP 対応
任意の MCP サーバーを通じて、エージェントはローカルの使用履歴やツール間のセッション情報を照会できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
すべてのAIコーディングエージェントのコストを追跡。上限に達する前に確認できます。
Claude Code、Codex、Cursorをはじめとする37種類以上のAIコーディングツールについて、セッション別・モデル別のコストを確認できます。
プロバイダーから実際に請求されたトークン数に基づいています。無料、Apache-2.0、そしてお使いのマシン上で実行できます。
クイックスタート · ドキュメント · 比較 · 変更履歴 · ウェブサイト
1つのコマンドで試す
npx @superbased/observer
インストールも設定もネットワーク接続も不要です。コーディングエージェントがすでにディスク上に保存しているセッションログを読み取り、ツール別・モデル別の30日間のコスト表を出力し、終了時に一時データベースを削除します。
SuperBased を選ぶ理由
Claude Code のトークン使用量、Codex のコスト、Cursor の支出を横並びで追跡し、 管理を支援する単一のローカルバイナリです。
- 推定ではなく、プロバイダー準拠の正確なコスト。 オプションのローカルプロキシが、プロバイダーから返されたトークンを記録します。実際の入力、5 分と 1 時間のキャッシュ書き込み、推論トークン、長いコンテキストの再価格設定が含まれます。ログのみを追跡するツールでは、これらを推定する必要があります。
- あらゆるコーディングエージェントを一か所に集約。 40 個のアダプターが Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI、Cline、Aider、Kiro、Devin、OpenCode、Junie などを正規化し、単一のローカルデータベースにまとめます。
- ローカル優先で、アカウント不要。 テレメトリもサインインもありません。ウォッチャー、ダッシュボード、MCP サーバー、CLI がユーザーに代わって外部へ接続することはありません。すべては
~/.observer/にある単一の SQLite ファイルに保存されます。 - 請求が確定する前に、次の請求額を把握。 期限切れ警告付きのプロンプトキャッシュ追跡、次のメッセージの低・標準・高のコスト範囲、プロキシ経由のセッション向けの 5 時間および週間上限ゲージを利用できます。
- 自分のエージェントにガードレールを設定。 ガードは各エージェントのアクションを組み込みルール(破壊的なコマンド、シークレットの外部送信、MCP の固定、予算)とユーザー独自のルールに照らして確認します。初期状態は監視モードです。
observer guard simulateで履歴を再生してから、強制モードを有効にできます。 - どこからでも、自分のエージェントをターミナルとして利用。 ダッシュボードからエージェントの CLI を実際のターミナルとして起動し、Tailscale のテールネット経由でペアリング済みデバイスから実行中のセッションに参加したり、あるツールから別のツールへセッションを引き継いだりできます。
比較
| SuperBased | ccusage | CodeBurn | Langfuse | Helicone | LiteLLM | |
|---|---|---|---|---|---|---|
| 対象 | コーディングエージェントのコストと管理 | CC/Codex のコストメーター | ローカルでの CC 支出と予算管理ツールキット | LLM アプリの可観測性 | LLM アプリの可観測性とゲートウェイ | AI ゲートウェイ |
| 対応するコーディングツール | 40 個のアダプター | Claude Code、Codex、および関連パッケージ | 独自ドキュメントによると 31~36 個 | アプリごとに計測 | アプリごとに計測 | 経由するすべてのツール |
| プロバイダー報告のトークン(推定ではない) | ✓ ローカルプロキシ経由 | 一部対応(ログから取得) | 一部対応(ログから取得) | ✓(SDK) | ✓(プロキシ) | ✓(プロキシ) |
| キャッシュの 5 分と 1 時間の書き込みを区別 | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| 推論と長いコンテキストの追加料金の計上 | ✓ | 一部対応 | 一部対応 | 一部対応 | 一部対応 | 一部対応 |
| 100%ローカルで動作し、クラウド不要 | ✓ | ✓ | ✓(チーム同期プレビューはオプトイン) | スタックをセルフホスト | セルフホストまたは SaaS | セルフホスト |
| 履歴をエージェントから照会できるメモリ(MCP) | ✓ | ✓(使用状況 MCP) | ✓ | ✓(トレース MCP) | ✗ | ✗ |
| ツール間のセッション引き継ぎ | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| ライセンス | Apache-2.0 | MIT | MIT | MIT(コア) | Apache-2.0 | MIT |
各プロジェクトの公開リポジトリに基づく確認(2026 年 7 月)。これらのツールはそれぞれ、開発時に想定された用途に適しています。詳しい比較では、さらに多くのツールを取り上げ、どれを選ぶべきかを解説しています。
インストール
| チャネル | コマンド |
|---|---|
| npm | npm install -g @superbased/observer |
| PyPI | uv tool install superbased-observer(または pipx install / pip install) |
| VS Code | code --install-extension superbased.superbased-observer(Cursor、VSCodium、Windsurf の場合:Open VSX) |
| インストーラー | curl -fsSLO https://github.com/superbasedapp/observer/releases/latest/download/install.sh && sh install.sh |
すべてのチャネルで、Linux(x64、arm64)、macOS(Intel、Apple Silicon)、Windows x64 向けの同一のビルド済み純粋な Go バイナリを配布しています。インストーラー(Windows では install.ps1)では、より小さいエディション(minimal、developer、managed)も選択できます。各アーカイブを SHA256SUMS とその Ed25519 署名で検証し、sudo を実行せず、--from-dir によるオフラインインストールにも対応しています。すべてのオプションを確認するには、sh install.sh --help を実行してください。
はじめに
observer start # proxy + watcher + dashboard; opens http://localhost:8081
observer scan # backfill history from the session logs already on disk
- エージェントをプロキシ経由にルーティングして、プロバイダーと完全に一致するトークン数を取得します。ダッシュボードで「Compression」を開き、ツールのステータスピルをクリックして、**「Route through the observer proxy」**を選択します。設定変更内容がプレビューされ、確認後にのみ書き込まれます。一度だけ使う場合は、
observer claude/observer codex、またはANTHROPIC_BASE_URL=http://localhost:8820も利用できます。 - 通常どおりエージェントを使います。 セッション、コスト、キャッシュの数値が数分以内に表示されます。
- 任意:
observer initを実行すると、エージェントが自分の履歴を照会できるよう、MCP サーバーも登録されます(各ターンにツールスキーマが追加されるため、オプトイン方式になっています)。
observer doctor でインストールを確認し、observer status で取得済みの情報を表示できます。
- ダッシュボード(
localhost:8081):概要、ライブ、セッション、コスト、プランと上限、キャッシュ、セキュリティ、設定などを表示します。ツールやプロジェクトで絞り込め、スマートフォンでも読みやすい設計です。 - 照合可能なコスト:セッション、モデル、プロジェクト、ツールごとに、キャッシュの読み取りと書き込みの内訳を確認できます。セッションの詳細では、API の各ターンまで掘り下げられます。
- ツール間のメモリ:オプトイン方式の MCP サーバーを使うと、エージェントは同じリポジトリで別のエージェントがすでに読んだ内容、実行したコマンド、壊したものを確認できます。また、
observer <tool> --continue-from <session>による引き継ぎにも対応しています。 - 無駄の検出:古い情報の再読み込み、コマンドの繰り返し実行、複数のエージェントが競合しているファイルを検出します。
- ターミナル:デーモンが管理する PTY ターミナルで、複数シートの同時参加、ライブのコスト管理画面、再起動後のネイティブな再開に対応します。
- エディターとシェル:VS Code 拡張機能(ステータスバー、サイドバー、ダッシュボードタブ)、1 行の
observer statusline、あらゆる操作に使える CLI(observer usage、cost、predict、tail)を提供します。
![]() セッション:すべてのエージェントの全セッションと、コスト、タグを確認できます。 | ![]() キャッシュ:どのプロンプトキャッシュが有効で、いつ期限切れになるかを確認できます。 |
対応エージェントには、Claude Code、Codex、Cursor、Copilot と Copilot CLI、Gemini CLI、Cline と Cline CLI、Antigravity、OpenCode、OpenClaw、Pi、Hermes、Kilo Code、Qwen Code、Kiro CLI、Kiro Crew、 Crush、Kimi Code、Grok、Devin、Aider、Qoder、goose、droid、Open Interpreter、Command Code、Junie、 Poolside、Zed、Mistral Code、Muse、Prime Agent、DeepSeek、zcode、Freebuff、Cowork、Grok Bot のほか、 オプションのブラウザー拡張機能を通じて Web 上で利用する ChatGPT、Claude、Gemini、Copilot、Perplexity が含まれます。 ツールごとのセットアップ:superbased.app/docs/track。
セッションの詳細
任意のセッションをクリックすると、詳細ビューが開きます。4 つのタブのうち、以下をご紹介します。
![]() 概要:コスト、課金ティア別のトークン数、使用したモデルを確認できます。 | ![]() メッセージ:各メッセージのモデル、ツール呼び出し、コストを確認できます。 |
![]() コストと上限:次のメッセージにかかるコストと、上限の残りを確認できます。 | ![]() キャッシュ:セッションの稼働中キャッシュ、ヒット、書き込み、再書き込みを確認できます。 |
プライバシー
SuperBased はテレメトリーを送信せず、アカウントも必要ありません。パス、コマンド、短い抜粋を保存し、書き込み前に秘密情報を除去します。また、プロキシとダッシュボードはデフォルトで 127.0.0.1 にバインドされます。プロキシは、お使いのリクエストを変更せずに、すでに利用しているプロバイダーへ転送します。observer uninstall --all --purge ですべてを削除できます。詳細:PRIVACY.md。
ドキュメント
- クイックスタートと インストール方法
- エージェントを接続すると ツールごとのコストを追跡する
- ガイド:ダッシュボード、 トークンとコストの追跡、 キャッシュの追跡、 コスト予測、 ターミナル、 セキュリティガード、 MCP サーバー
- リファレンス:CLI、 設定、 計測の誠実性
組織向け
エンジニアリング組織全体でコーディングエージェントを運用していますか?SuperBased では、開発者、予算、ポリシーを一元的に可視化できるほか、SSO サインインも利用できます。 組織向け SuperBasedをご覧いただくか、[email protected] までお問い合わせください。
コミュニティ
質問はディスカッション、バグ報告やアダプターのリクエストはイシューへお寄せください。セキュリティに関する報告はSECURITY.mdからお願いします。プルリクエストも歓迎します。CONTRIBUTING.mdをご覧ください(ビルドには Go 1.26 以降が必要で、CGO は不要です)。SuperBased によって思いがけない請求を避けられたら、スターを付けてほかの人にも見つけてもらいましょう。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。





