AgentLimits マニュアル

メニューダッシュボード

メニューバーアイコンをクリックすると、メニュー上部に各プロバイダーの使用状況ダッシュボードが表示されます：

• ヘッダー: サービス名・5h枠の残り時間・週次リセットまでの日数、または月間のみのプロバイダでは月間リセット
• 使用率バー: 使用率を線形バーで表示。ペースメーカー超過時はウィジェットのドーナツリングと同じセグメント色分け（緑 → オレンジ → 赤）
• ペースメーカーバー: 5h=5分割・週次=7分割・月間=分割なしのセグメントバー。ウィジェットの内側リングと同じ動作
• ダッシュボード行をクリックすると対応サービスの使用状況ページをブラウザで開きます。カスタムサービスは設定済みのHTTP/HTTPS URLを開き、URL未設定ならそのサービスの設定を開きます
• 使用量 タブの「メニューにダッシュボードを表示」でプロバイダごとに表示/非表示を切替可能
• メニューには: 表示モード・言語（システムまたは同梱されている翻訳）・Wake Upの今すぐ起動・ログイン時にアプリを起動・アップデートを確認... も含まれます
• システム を選択すると、対応しているOS言語を使用し、OS言語が未対応の場合はEnglishにフォールバックします。

使用量ウィジェット（Codex / Claude Code）

• ダブルドーナツ: 5時間・週の2つのウィンドウを横並び表示
• Codexが週次ウィンドウだけを返す場合、5時間ドーナツは未取得のまま、週次ドーナツには使用量を表示します
• 一部のCodexプランでは、Codex APIが月間ウィンドウのみを返す場合に月間のシングルドーナツを中央表示
• 使用率と表示モードに応じて色分け表示
• 更新時刻は HH:mm 形式（24時間以上前なら --:--）

使用量ウィジェット（GitHub Copilot）

• シングルドーナツ: 月間プレミアムリクエスト枠を中央配置
• ペースメーカー内側リングは週分割（請求期間に応じて4〜5セグメント）
• 中央ラベル: 1mo
• 使用率と表示モードに応じて色分け表示
• 更新時刻は HH:mm 形式（24時間以上前なら --:--）

カスタム使用量ウィジェット

• 1種類の カスタム使用量 ウィジェットを追加し、右クリックして 「カスタム使用量」を編集... からサービスを選択します
• 複数のウィジェットインスタンスで、それぞれ異なるカスタムサービスを選択できます
• 小・中サイズとも 5h → 1w → 1month 順で1〜2枠を表示し、使用量の色、使用率/残り率、ペースメーカー、更新時刻を共通利用します
• 各枠に任意の label を指定できます。カスタムラベルはウィジェット、ダッシュボード、通知設定に表示され、ペースメーカーリングは分割されません
• resetAt または durationSeconds がない枠、または isPacemakerEnabled: false の枠は、ペースメーカーリングと比較インジケーターなしで使用量を表示します
• 選択済みサービスを削除すると、サービスを利用できないことを表示します

トークン使用量ウィジェット（Codex / Claude Code）

• 小サイズ: 今日 / 今週 / 今月のサマリー（コスト + トークン数）
• 中サイズ: サマリー + GitHub風ヒートマップ
  • 7行（日〜土）× 4〜6列（週）
  • 四分位に基づく5段階の色濃度
  • 曜日ラベル（Mon, Wed, Fri）表示
  • デスクトップ固定モード対応（アクセント / グレースケール）
• ウィジェットタップ時の動作を設定可能（デフォルトは https://ccusage.com/ を開く）

プレミアムリクエスト使用量ウィジェット（GitHub Copilot）

• 小サイズ: 今日 / 今週 / 今月のサマリー（コスト + プレミアムリクエスト数）
• 中サイズ: サマリー + GitHub風ヒートマップ
• Copilot使用量の更新時に自動取得（WebView経由、CLI不要）
• ウィジェットタップ時の動作を設定可能（デフォルトは https://ccusage.com/ を開く）

使用量

1. 使用量タブを開く
2. Codex / Claude Code / Copilot を選択
3. 更新間隔（1〜10分）を選択
4. 「メニューバーに表示」でアイコンエリアへの使用率表示をプロバイダごとに切替
5. 「メニューにダッシュボードを表示」でメニューのダッシュボード行をプロバイダごとに切替
6. 「表示順」の行をドラッグして、メニューバーアイコンとダッシュボードのプロバイダ表示順を変更
7. 画面下部のログインバー（▲）を押して、埋め込みWebViewパネルを展開
8. WebViewでログイン（chatgpt.com / claude.ai / github.com）
9. ログインが詰まる場合やログイン実績をリセットしたい場合は データを削除 でログイン情報、サイトデータ、保存済みの使用量スナップショットを消去

Wake Up

1. Wake Upタブを開く
2. プロバイダ（Codex / Claude Code）を選択 ※ Copilotは対象外
3. スケジュールを有効化
4. 実行したい時刻（0〜23時）を選択
5. 「今すぐテスト実行」でCLI動作を確認

通知

1. 通知タブを開く
2. 通知権限をリクエスト（初回のみ）
3. サービスメニューから組み込みまたはカスタムサービスを選択
4. 取得済みの意味ベースの枠（5時間、週、月）ごとに閾値を設定
5. 使用率の色（ドーナツ色/ステータス色）を必要に応じて調整

ペースメーカー

1. ペースメーカータブを開く
2. メニューバーのペースメーカー値表示を切替
3. ウィジェットのリング警告セグメント表示を切替（ペースメーカー超過時の色分けセグメント）
4. 警告/危険の超過閾値を調整
5. ペースメーカーのリング色/文字色を調整

ccusage

1. ccusageタブを開く
2. プロバイダ（Codex / Claude Code）を選択
3. 更新間隔（1〜10分）を選択
4. 「定期取得を有効にする」をオンにし、必要なら追加CLI引数を設定
5. 「今すぐテスト実行」でCLI動作を確認
6. Copilotの場合: Copilot使用量の更新時に自動取得されます — トグルをオンにするだけでOK

カスタム使用量

1. カスタム使用量 を開き、サービスを追加します
2. 表示名と、^[a-z0-9][a-z0-9_-]{0,62}$ に一致する変更不可の小文字Provider IDを入力します
3. 実行可能な通常ファイルを選択します。AgentLimitsはそのファイルを親フォルダから直接実行し、引数や自由入力のシェルコマンドは受け付けません
4. 必要ならHTTP/HTTPSのWebサイトを追加し、自動更新、メニューバー、ダッシュボード表示を選択します
5. テスト実行 で、設定した実行ファイルを確認します
6. カスタムサービスは使用量の更新間隔を使用します。自動更新が無効でも、手動テストとウィジェットの更新タップは実行できます

アップデート

1. アップデートタブを開く
2. 現在のバージョンと最終確認時刻を確認します
3. 今すぐ確認 で手動更新確認を実行します
4. 自動更新確認を切り替えます
5. リリース内容が必要な場合はリリースページを開きます

詳細設定

1. 詳細設定タブを開く
2. codex / claude / npx のフルパスを必要に応じて指定（空欄ならPATHから解決）
3. PATH解決結果を確認
4. ウィジェットタップ時の動作を選択（サイトを開く / データ更新）
5. 「メニューバーアイコンを隠す」でアイコンを完全に非表示にできます。非表示中に設定を開くには、起動中のままアプリアイコンをダブルクリックしてください。
6. ステータスライン用スクリプトのパスを必要に応じてコピー

スクリプトを作成するには

組み込みではないサービスのスクリプトを作成するには、AIコーディングエージェントに作成を依頼します。scripts/CUSTOM_USAGE_SCRIPT_GUIDE.md をエージェントに渡してください。必要な決定事項、実行時の制約、JSON契約、検証ルールが定義されているため、対象サービス用の実行ファイルを実装・テストできます。scripts/cursor_usage.py と scripts/antigravity_usage.py にサンプルがあります。

まだここに無いサービス向けのスクリプトを作成した場合は、scripts/ 配下に新しいサンプルとして追加するプルリクエストをぜひ送ってください。他のユーザーが自分の環境に合わせて活用できます。

JSONスナップショットの仕様

実行ファイルは60秒以内に終了コード0で終了し、stdoutへJSONオブジェクトを1つだけ出力する必要があります。診断ログはstderrへ出力してください。

stdoutの例：

{
  "schemaVersion": 1,
  "provider": "cursor",
  "fetchedAt": "2026-08-23T12:34:56Z",
  "windows": [
    {
      "kind": "5h",
      "label": "Fast Requests",
      "title": "高速リクエスト枠",
      "usedPercent": 42.5,
      "resetAt": "2026-08-23T15:00:00Z",
      "durationSeconds": 18000,
      "usedCount": 425,
      "limitCount": 1000
    },
    {
      "kind": "1w",
      "usedPercent": 68,
      "resetAt": "2026-08-30T00:00:00Z",
      "durationSeconds": 604800
    }
  ]
}

fetchedAt はタイムゾーン付きISO 8601で指定します。kind は 5h / 1w / 1month のどれにも対応しない任意区間・区間なしの枠には custom を指定できます（表示順は常に最後、label未指定時の既定ラベルは •）。label、title、resetAt、durationSeconds、isPacemakerEnabled は任意です。labelはドーナツ中央やダッシュボードの短いラベル、titleはWidget詳細列・通知設定の見出し・通知本文で使う長めの見出しで、互いに独立して指定できます。titleを省略するとlabel、labelも省略するとkindの既定文言にフォールバックします。resetAtはタイムゾーン付きISO 8601、durationSecondsは正数にします。usedCount と limitCount は任意ですが、使用する場合は両方を非負整数で指定し、limitCount > 0 とします。未知フィールドは許容されます。期限なしの枠は、使用量が閾値未満に戻ってから再び超過した場合だけ、有効な閾値通知を再送します。stdout上限は256 KiB、stderr上限は64 KiBです。無効な出力で最終成功スナップショットが上書きされることはありません。