AgentLimits マニュアル

ダウンロード

最新版はこちらからダウンロードしてください: ダウンロード

クイックスタート（初回セットアップ）

1. AgentLimitsアプリを起動
2. 通知センターでウィジェットを追加
3. メニューバーから AgentLimits設定... を開く
4. 使用量タブで Codex / Claude Code / Copilot を選び、更新間隔（1〜10分）を設定し、画面下部のログインバー（▲）を開いてログイン
5. メニューバーの 表示モード で「使用/残り」を切り替え、必要に応じて 今すぐ更新

取得する情報

• 使用量（Codex / Claude Code）: 5時間/週の使用量を内部APIから取得
  • Codex: https://chatgpt.com/backend-api/wham/usage
  • Claude Code: https://claude.ai/api/organizations/{orgId}/usage
• 使用量（GitHub Copilot）: 月間プレミアムリクエスト枠をentitlement APIから取得
  • Copilot: https://github.com/github-copilot/chat/entitlement
• トークン使用量（ccusage）: CLIで日/週/月のトークン数とコストを取得
  • Codex: npx -y ccusage@latest codex daily
  • Claude Code: npx -y ccusage@latest claude daily
• プレミアムリクエスト使用量（Copilot）: WebView経由で日別のプレミアムリクエスト数とコストを取得
  • API: https://github.com/settings/billing/usage_table（Copilot使用量の取得時に自動取得）

メニューバー表示

• アイコンエリアにプロバイダごとに2行表示
  • 1行目: サービス名
  • 2行目: X% / Y%（5時間 / 週）
  • Copilotの場合は X%（月間）
• 表示モード: 使用率 / 残り率（アプリとウィジェットで共通）
• 色分け: ペースメーカー比較に基づく表示（色は 通知 タブで設定）
• メニューバー上のステータス色は、現在のメニューバー文字色に合わせて自動的に暗く/明るく補正されます
• ペースメーカー表示: ペース超過時に ↑ を表示
• 表示のオン/オフは 使用量 タブでプロバイダごとに切替
• プロバイダの表示順（Codex / Claude Code / Copilot）は 使用量 タブの「表示順」でドラッグして並べ替え可能

メニューダッシュボード

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

• ヘッダー: サービス名・5h枠の残り時間・週次リセットまでの日数
• 使用率バー: 使用率を線形バーで表示。ペースメーカー超過時はウィジェットのドーナツリングと同じセグメント色分け（緑 → オレンジ → 赤）
• ペースメーカーバー: 5h=5分割・週次=7分割のセグメントバー。ウィジェットの内側リングと同じ動作
• ダッシュボード行をクリックすると対応サービスの使用状況ページをブラウザで開く
• 使用量 タブの「メニューにダッシュボードを表示」でプロバイダごとに表示/非表示を切替可能
• メニューには: 表示モード・言語（システム/日本語/English）・Wake Upの今すぐ起動・ログイン時にアプリを起動・アップデートを確認... も含まれます

ペースメーカー

ペースメーカーは、時間経過に基づく使用量の目安を表示し、ペース配分に役立てます。

• 計算方法: ウィンドウの経過時間割合（例: 50% = 5時間・週の半分が経過）
• 色分け: 緑 = 目安以下（順調）、オレンジ = やや超過、赤 = 10%以上超過
• メニューバー: <使用率>% (<ペースメーカー>)% 形式で表示（表示切替は ペースメーカー タブ）
• ウィジェット: 外側リング = 実際の使用率、内側リング = ペースメーカー値（取得できる場合に表示）
  • 使用率モード時のみ、ペースメーカー超過時は外側リングを色分けセグメント表示（緑 → オレンジ → 赤で警告/危険範囲を表示、ペースメーカー タブで切替可、デフォルトは有効）
• 閾値設定: 警告・危険の超過閾値は ペースメーカー タブで設定可能
• 色設定: ペースメーカーのリング色・文字色は ペースメーカー タブで設定可能

ウィジェット

設定ガイド

Wake Up（CLIスケジューラ）

• 実行コマンド例:
  • codex exec --skip-git-repo-check "hello"
  • claude -p "hello"
• LaunchAgentのplist: ~/Library/LaunchAgents/com.dmng.agentlimit.wakeup-*.plist
• ログ: /tmp/agentlimit-wakeup-*.log
• 追加の引数はプロバイダごとに設定可能

Claude Code ステータスライン用スクリプト

• Claude Code ステータスライン向けの同梱スクリプト（詳細設定 → 同梱スクリプト にパス表示）
• Claude Code使用量スナップショット + App Group 設定（表示モード/言語/閾値/色）を参照
• 5時間/週の使用率、リセット時刻、更新時刻を1行で出力
• オプション: -ja / -en / -r（残り表示） / -u（使用率表示） / -p（ペースメーカー表示） / -i（使用率+ペースメーカー併記） / -d（デバッグ）
• jq が必要（brew install jq）

参考: App Groupの保存先

スナップショットはApp Groupコンテナに保存されます。

~/Library/Group Containers/group.com.dmng.agentlimit/Library/Application Support/AgentLimit/
├── usage_snapshot.json
├── usage_snapshot_claude.json
├── usage_snapshot_copilot.json
├── token_usage_codex.json
├── token_usage_claude.json
└── token_usage_copilot.json

注意 / トラブルシューティング

• 内部APIは変更される可能性があります。
• ccusageのCLI出力が変わると取得に失敗する可能性があります。
• ウィジェットの更新頻度はOSにより間引かれる場合があります。
• 閾値通知には通知権限が必要です。
• CLI実行はユーザーのログインシェルで行い、PATHは /opt/homebrew/bin:/usr/local/bin:$HOME/.local/bin:$PATH を先頭に追加します。
• 詳細設定でフルパスを指定した場合は、そのパスを優先して実行します。
• Claude OAuth は通常、同梱された公開 Claude Code Client ID を使います。詳細設定の上書きは互換性復旧用です。
• Claude Codeのログインに失敗し、複数回のログイン作業が必要になる可能性があります。
• Claude Code ステータスライン用スクリプトは jq が必要です。
• 設定ウィンドウの縦方向の最小サイズは 620 です（下部ログインバーを常に見える状態にするため）。

自動アップデート

AgentLimitsは Sparkle を使用した自動アップデートに対応しています。

• 起動時チェック: アプリの起動時に自動でアップデートを確認します。
• 定期チェック: バックグラウンドで24時間ごとに確認します。
• 手動チェック: 設定画面の アップデート タブ、またはメニューバーメニューの アップデートを確認... から実行できます。
• 確認後ワンクリックでダウンロードとインストールが完了します。