Iamshankhadeep/ccseva

何を解決するか

CCSeva は、Claude Code のユーザーがトークンの消費量、コスト、およびサーバー側の使用制限をリアルタイムで追跡できるようにする、軽量な macOS メニューバー アプリです。手動で制限を確認する必要がなく、5時間のセッションブロックや週間利用状況について即座に可視化できます。

動作方法

このアプリは Swift と SwiftUI でネイティブに構築されており、メニューバー専用のアプリとして動作します。ローカルの ~/.claude トランスクライブ（JSONL ファイル）を直接解析して使用量を計算します。また、Claude Code の OAuth 使用量エンドポイントを読み取り、「サーバーの真実」に基づく制限ゲージを提供します。エンドポイントが利用できない場合は、ローカルでの推定値をフォールバックとして使用します。

対象ユーザー

macOS 上で Claude Code を使用する開発者やパワーユーザーで、ターミナルから離れず、重いランタイム依存関係を使わずに API コストやトークン消費速度を監視したい方。

主な特徴

• リアルタイム メニューバー追跡: macOS メニューバーに色分けされたステータスで使用率を表示。
• サーバーの真実に基づくゲージ: 5時間ごとの利用状況と週間利用状況を追跡。他のデバイスからの利用も含み、予測される切断時刻を表示。
• ネイティブパフォーマンス: ランタイム依存関係ゼロ（Electron や Node.js なし）の約 3 MB のアプリバンドル。
• 詳細な分析: Swift Charts を使用して、モデル別・プロジェクト別にコストの内訳を表示。
• ネイティブ通知: 使用率が 70% および 90% に達したときにユーザーに通知。
• オプション同期: claudecode.directory との同期をオプトインし、プライベートな使用状況ダッシュボードを活用可能。