この翻訳は英語版 README より古い場合があります。英語版が正となります。

なぜ必要か

複数の AI ツールでコーディングしていると、同じ壁に何度もぶつかります。作業の途中で 5 時間の上限に達し、別のツールを開いて、タスクを最初から説明し直すことになります。使用量の表示場所はサービスごとにばらばらで、表示されないものもあります。

Vibe Usage は、お使いのマシンですでにサインインしているセッションを読み取り、すべての上限を並べて表示します。残りがどれだけあり、いつリセットされるかがわかります。あるツールが残り少なくなると、クォータが確認できた次のツールをプロジェクトフォルダーで起動し、現在のセッションの要約を書き出します。新しいツールは前のツールが止まったところから作業を続けられます。

機能

クォータをひと目で すべてのアカウントのすべての上限: 5 時間枠と週間枠、モデル別の枠、利用額の枠。カウントダウンで各枠のリセットまでの時間がわかります。更新に失敗しても最後の計測値は表示されたままで、古いデータであることがはっきり示されます。不明な値が満タンのクォータとして表示されることはありません。トレイアイコンにポインターを合わせると各ツールの残りが表示されます。希望すれば、上限が少なくなったときや再び使えるようになったときに通知します。ログイン時に起動することもできます。
スマート起動 優先順位の中で、クォータに余裕があることが確認できた最初のツールを選び、指定したプロジェクトフォルダーで新しいターミナルを開いて起動します。どのツールも確認できない場合は、推測せずにそう伝えます。
引き継ぎ Claude Code、Codex、Cursor Agent、Antigravity のセッションを選びます。VIBE_HANDOVER.md には目的、最新の依頼、最近の会話、ファイル参照、Git のブランチ/HEAD 情報が入ります。作業ツリーは走査しません。プレビューは実際の保存元、アカウント、バージョンを固定し、元データが変わると再プレビューが必要です。worktree に移動したセッションは対応するプロジェクトに表示されます。
複数アカウント Claude と Codex はプロファイルフォルダーごとに 1 つのサインインを保持します。アカウントを追加 は新しいフォルダーを作成し、そこでツールのサインインを開きます。自分で作成した ~/.claude-* と ~/.codex-* のフォルダーも自動で見つかります。各アカウントはサインインしているメールアドレスで表示され、サインイン済みの各 Antigravity アカウントも個別に追跡します。メインアカウントの選択、特定のアカウントでの Claude Code の起動、ツールごとの代替順序と優先モデルの設定ができます。10 分以内にサインインが終わらなければアカウントは再び外され、次のアカウントがそのフォルダーを使います。

設定・履歴・診断

一般: ログイン時に起動、残量が少ないときの通知、通知しない時間帯、アカウントの横並び表示、更新の確認。	上限に達したとき: 提案のみ、同じツールの別アカウントで続行、さらにフォールバック順で他のツールへ。プロジェクトごとにも設定できます。	順序とモデル: ツールの表示順、次に引き継ぐツール、各ツールが起動時に使うモデル、クォータを読む間隔。
引き継ぎ履歴: どの作業がどのアカウントからどこへ移ったか。失敗したものはワンクリックで再試行できます。	診断: 各ツールがインストールされているか、各アカウントの状態。名前やフォルダーを含まないレポートをコピー・保存できます。

対応ツール

ツール	クォータの取得元	引き継ぎ用のセッション	起動
Claude Code	プロファイルの OAuth 使用量エンドポイント (macOS ではキーチェーン)	~/.claude/projects	選んだプロファイルで claude CLI
Codex	インストール済み CLI の app-server のレート制限メソッド	~/.codex/sessions	codex CLI
Cursor	サインイン中のセッションの使用量サマリー	Cursor Agent CLI のチャット (~/.cursor/chats)	cursor-agent、なければアプリ
Antigravity	起動中アプリのローカルサービス (プロセスとポートの所有者を検証)	~/.gemini/antigravity-ide	Antigravity アプリ

モデルの一覧は各ツール自身のデータから取得します: Claude Code のエイリアスと使用したモデル、Codex のモデルキャッシュ、cursor-agent --list-models (24 時間キャッシュ)。

プライバシーと安全性

既存の認証情報をメモリ上で読みます。その文書にはアクセストークンと更新トークンが含まれる場合があります。アプリは更新トークンの有無を確認しますが、自身のデータには保存しません。更新は Claude Code が行います。

設定、アカウント名、パス、クォータ履歴と最新の測定値はローカルディスクに保存されます。別アカウントで続行すると会話全体がコピーされます。VIBE_HANDOVER.md は機密情報を伏せた会話の文脈を含みますが、すべての秘密情報の形式を検出できる保証はありません。引き継ぐ前にプレビューを確認してください。Git が追跡中のファイルや Git からの除外失敗は引き継ぎを停止します。Cursor 独自の信頼確認は維持されます。

クォータは提供元のエンドポイント、バージョン確認は GitHub を利用します。更新のダウンロードとインストールは別々のユーザー操作です。詳しくはプライバシーとローカルデータをご覧ください。

インストール

Windows

最新リリース から Vibe-Usage-<バージョン>-win-setup.exe をダウンロードして実行します。現在のユーザーにだけインストールされ、管理者権限は不要です。ポータブル版の Vibe-Usage-<バージョン>-win-x64.zip (または -arm64) を展開して Vibe Usage.exe を実行することもできます。対応する署名付きインストール版は、ダウンロード を押すと更新を取得し、再起動して更新 を選ぶとインストールします。ポータブル版は新しいバージョンのリンクを表示します。アプリはタスクトレイに常駐します。

アプリはコード署名されていないため、初回起動時に Windows SmartScreen が「Windows によって PC が保護されました」と表示することがあります。詳細情報をクリックし、実行を選んでください。

macOS

最新リリース から Vibe-Usage-<バージョン>-mac-arm64.dmg (Apple シリコン。Intel は -mac-x64.dmg) をダウンロードして開き、Vibe Usage をアプリケーションフォルダーにドラッグします。アプリはまだ Apple Developer ID で署名されていないため、初回起動は Gatekeeper にブロックされます。システム設定 › プライバシーとセキュリティ を開いて このまま開く をクリックするか、次を実行します:

xattr -dr com.apple.quarantine "/Applications/Vibe Usage.app"

この手順を省きたい場合は自分でビルドします。必要なのは Node.js 24 だけです:

git clone https://github.com/mustafacagri/vibe-usage.git && cd vibe-usage
npm ci
npm run build:mac
cp -R "release/mac-arm64/Vibe Usage.app" /Applications/

Intel Mac ではフォルダー名が release/mac になります。自分でビルドしたアプリは隔離されず、そのまま開きます。macOS では署名済みのアプリしか自分自身を置き換えられないため、新しいバージョンも同じ方法でインストールします。アプリの ダウンロード ボタンでお使いの Mac 用のディスクイメージを取得できます。

コマンドライン

同じデータはターミナルでも見られます。Windows と macOS で、デスクトップアプリの有無にかかわらず動きます。Node.js 24 以降が必要で、アプリと同じサインイン済みセッションを読みます。両方をインストールしている場合は設定と言語を共有します。

npm install -g vibe-usage-cli
vibe-usage status

vibe-usage status [--json]   # 全アカウントのクォータを 1 回表示。スクリプト向けに --json
vibe-usage watch             # 同じ内容を Ctrl+C まで更新し続ける
vibe-usage run <claude|codex|cursor> [--account ID] [--cwd PATH] [--model MODEL] [--dry-run]
vibe-usage handover [--from TOOL] [--to TOOL] [--session ID] [--cwd PATH]
vibe-usage help

インストールせずに試すには npx vibe-usage-cli status を実行します。

run はクォータが確認できたアカウントでツールをこのターミナルで起動します。そうでない場合は --account でアカウントを指定してください (ID は status --json に出ます)。--dry-run は何も起動せずにアカウントとコマンドを表示します。handover はフォルダーの最新セッション (または --session) の VIBE_HANDOVER.md を書き、それを使って移行先のツールを開きます。

開発

コマンド、プロジェクト構成、環境変数については英語版 README の「Development」を参照してください。

制限事項

• macOS 版は公証 (notarization) されていません (macOS を参照)。
• Antigravity のセッションのモデルは非公開のローカル記録から読み取ります。読み取れない場合、モデルは空欄になります。
• Cursor IDE (Composer) のチャットは引き継げません。読み取るのは Cursor Agent CLI のセッションだけです。

ライセンス

MIT