GitHub - peterxcli/ccost: ローカルのAIコーディングセッションログをコストレンズ付きで検索可能なターミナルUIに変換します。

数秒間に古いCodexとClaude Codeセッションを探し、どれが最もトークンを消費したかを見つけ出す.

ccostは、ローカルのAIコーディングセッションログを検索可能なターミナルUIに変換し、コストの観点から分析します。これを使って過去のプロンプトを復元し、高価な実行を検査し、どのセッション、モデル、ウェブ検索呼び出しがあなたのコストに影響したかを理解します.

codex-cost-demo.mov

brew install --cask peterxcli/tap/ccost
ccost

なぜこれを使うのか？

バグを修正したり、APIを探索したり、便利なエラーに直面したりしたセッションを見つける.
見積もったコスト、トークン、時間、モデル、ウェブ検索、セッションID、または最初のプロンプトでセッションを並べ替える.
プロンプト、パス、スタックトレース、またはソースコンテキストをアップロードせずにCodexとClaude Codeのログを閲覧する.
変更されたファイルのみを再インデックスする持続的な検索インデックスで起動を速く保つ.

サポートされているソース

ソース	デフォルトパス
Codex	`$CODEX_HOME/sessions`、または`~/.codex/sessions`が設定されていない場合`CODEX_HOME`、
Claude Code	`~/.claude/projects`
カスタムJSONLディレクトリ	`ccost --sessions /path/to/jsonl/sessions`

インストール

brew install --cask peterxcli/tap/ccost

アップグレード：

brew update
brew upgrade --cask ccost

他のインストールパスはロードマップ上です：

cargo install ccost
cargo binstall ccost
Linuxリリースアーティファクト
シェルインストールスクリプト

実行

デフォルトのCodexセッションディレクトリを開く:

ccost

明示的にソースを選択:

ccost --codex
ccost --claude

カスタムセッションディレクトリを使用:

ccost --sessions /path/to/jsonl/sessions

...を使用する場合

古い修正を探す

CodexやClaude CodeについてJWT refreshを尋ねたことを覚えているが、どのプロジェクトやセッションにあったか思い出せない

/を押し、入力:

JWT refresh

高額なセッションを探す

コストでソートして、どの実行が最も推定支出を使ったかを確認する

押す：

までソートがcostになるまで

ウェブ検索が多いセッションを監査

検索呼び出しが見積もりに寄与したセッションを見つけるために、ウェブ検索でソートする

プライバシー

ccostはローカル優先です

APIキー不要
テレメトリ不要
ネットワークコール不要
アップロード不要
セッションJSONLファイルが真実の源です
キャッシュファイルは使い捨てでローカルに格納されます

キャッシュ形式のずれや破損が検出された場合、TUIで表示されるキャッシュフォルダを削除します。元のセッションログは変更されません

機能

ローカルセッションログにおけるフルテキスト検索.
プレフィックスマッチング、マッチハイライト、表示可能な検索カーソル.
総コスト、時間、トークン、ウェブ検索、モデル、セッションID、または最初のプロンプトによるコスト意識のあるソート.
CodexとClaude Codeのデフォルト設定、カスタムJSONLセッションディレクトリのサポート.
組み込みの価格表、ローカルJSONオーバーライドのサポート.
オプション--no-web-cost トークンのみの見積もり用モード.
単一ライターキャッシュロック、読み取り専用と強制書き込み用のエスケープハッチ.

なぜ速いのか.

RustターミナルUI.
永続化された全文インデックス.
FSTトークンインデックス、コンパクトなプレフィックス検索用.
永続化されたMerkle木とファイルウォッチャーがあり、変更されていないセッションは再利用され、変更されたセッションファイルはインクリメンタルに再インデックスされます。

コントロール

キー	アクション
`/`	検索モードに入る
`Enter`	ブラウズモードに戻る、またはブラウズ中に詳細を切り替える
`Up` / `Down` または `j` / `k`	選択を移動
`Tab`	スイッチリスト/詳細フォーカス
`s`	次のソートキー
`S`	逆ソート方向
`r`	リロード
`Esc`	検索クリアまたは戻る
`q`	終了

オプション

ccost [--codex | --claude | --sessions PATH] [--pricing PATH] [--no-web-cost] [--read-only-index] [--force-index]

--codex: デフォルトのCodexセッションディレクトリを開く.
--claude: デフォルトのClaude Codeプロジェクトトランスクリプトディレクトリを開く.
--sessions PATH：カスタムCodexまたはClaude Codeセッションディレクトリを開く（JSONLファイルを含む）。
--pricing PATH：ローカルの価格JSONオーバーライドをロード。
--no-web-cost：見積もりにおけるウェブ検索コストを無効化。
--read-only-index：保存された検索キャッシュなしで開く。
--force-index：ロックなしで書き込み。他のTUIが実行されていないことを確認した後にのみ使用。

Pricing

コストは、ローカルセッションログに存在するトークン使用量とモデルデータに基づいて見積もられています。組み込みの価格設定にはGPT-5.5、GPT-5.4、Claude Opus/Sonnet/Haikuモデルファミリー、およびウェブ検索のデフォルトが含まれます。ローカルテーブルを--pricing pricing.jsonで上書きします：

{
  "web_search_per_1k": 10.0,
  "models": {
    "gpt-5.5": {
      "input_per_m": 5.0,
      "cache_creation_input_per_m": 0.0,
      "cached_input_per_m": 0.5,
      "output_per_m": 30.0,
      "long_context_threshold": 272000,
      "long_context_input_multiplier": 2.0,
      "long_context_output_multiplier": 1.5
    },
    "gpt-5.4": {
      "input_per_m": 2.5,
      "cache_creation_input_per_m": 0.0,
      "cached_input_per_m": 0.25,
      "output_per_m": 15.0,
      "long_context_threshold": 272000,
      "long_context_input_multiplier": 2.0,
      "long_context_output_multiplier": 1.5
    },
    "claude-sonnet-4-5": {
      "input_per_m": 3.0,
      "cache_creation_input_per_m": 3.75,
      "cached_input_per_m": 0.30,
      "output_per_m": 15.0
    }
  }
}

古い価格設定の上書きについては、long_context_multiplierはまだ受け入れられ、入力/出力特定のフィールドが省略された場合、すべてのトークンクラスに適用されます。cache_creation_input_per_m はオプションで、デフォルトは 0.0 です。

ベンチマーク

ベンチマークの数値は、証拠として使用される前に、名前付きのマシンと再現可能なデータセットで測定されるべきです。docs/github-launch.md にある起動チェックリストには、それらの数値が利用可能になった後に記入するテーブルが含まれています。

これはどう違う？

ツール	フォーカス
`ccusage`	多くのエージェントにおけるトークンとコストの使用状況のCLIレポート
CodeBurn	AIコーディングツールのコスト監視ダッシュボード
`ccost`	CodexとClaude Codeセッションの検索と閲覧に最適化されたローカルTUI、コストに応じたソート機能付き

ロードマップ

サニタイズされたデータを使用した静的READMEスクリーンショット
GitHubのソーシャルプレビュー画像
cargo install ccost
Linuxリリースアーティファクト
デモの設定ファイルまたはccost --demo
JSON/CSVエクスポート
プロジェクトレベルのコストサマリー
カーソル、OpenCode、Gemini CLI、およびGooseのログサポート
カスタマイズ可能なテーマ
CIにおけるベンチマーク

貢献する

貢献は歓迎されており、特に新しいログソースやエクスポート形式に対してです。CONTRIBUTING.mdを参照してください。

もしccostが古いセッションの回復やトークンの行き先の理解を助けた場合、星を付けることでその維持の価値を示すことができます。

おすすめ購読元

Hacker News - Newest: "AI"