groove-admin-claude-statusline

groove-admin-claude-statusline

リッチな1行のClaude Codeステータスラインをインストールします。3つのスクリプトを~/.claude/hooks/に書き込み、設定を~/.claude/settings.jsonにマージします。

削除するには--uninstallを使用します。現在の状態を表示するには--listを使用します。

インストール後の状態

~/.claude/settings.jsonで、statusLineがステータスラインのスクリプトを指し、アクティブな/loopのcronジョブを追跡するPostToolUseフックとSessionEndフックが設定されます。ステータスラインはClaude Codeの各ターンで表示されます。

ステータスラインの表示内容

claude-sonnet-4-6 | myrepo@main (+3 -1) | 42k/200k (21%) | effort: high | 5h 12% @8:00pm | 7d 3% @mar 16, 9:00am | 2 loops | check deployment @4:10pm

セクション	説明
モデル	アクティブなモデルの表示名
リポジトリ@ブランチ	CWDのフォルダー名、gitブランチ、ステージ済み差分+N -N
トークン	使用済み／コンテキスト合計、使用率
努力度	現在の努力レベル（low／med／high）
5h／7d	リセット時刻付きのレート制限使用率（60秒間キャッシュ）
ループ	アクティブな/loopのcronジョブ数＋次に実行されるプロンプトと時刻

手順

--list

~/.claude/settings.jsonを読み込みます。statusLineが設定されているか、また各フックスクリプトが~/.claude/hooks/に存在するかを報告します。終了します。

--uninstall

~/.claude/settings.jsonからstatusLineを削除します。このスキルが追加した3つのCronCreate|CronDelete／SessionEndフックエントリを削除します。フックスクリプトは削除しません（手動でクリーンアップできるよう残します）。変更内容を報告します。終了します。

デフォルト（インストール）

1. ~/.claude/hooks/が存在しない場合は作成します。

2. 以下の3つのスクリプトを~/.claude/hooks/に書き込みます。差分を表示して確認を得ずに上書きしてはいけません。

3. 3つすべてのスクリプトを実行可能にします（chmod +x）。

4. ~/.claude/settings.json（デフォルトは{}）を読み込みます。以下のstatusLineエントリと2つのフックエントリをマージします。他のすべてのキーを保持します。重複したエントリは作成しません。

5. ~/.claude/settings.jsonを書き込みます。

6. 以下を報告します。

   ✓ statusline.sh         → ~/.claude/hooks/statusline.sh
   ✓ cron-state.sh         → ~/.claude/hooks/cron-state.sh
   ✓ cron-state-clear.sh   → ~/.claude/hooks/cron-state-clear.sh
   ✓ ~/.claude/settings.json updated
   Note: restart Claude Code for changes to take effect.
   

スクリプト

3つのシェルスクリプトは、Agent Skills specificationに従って scripts/にあります。

スクリプト	インストール先	用途
scripts/statusline.sh	~/.claude/hooks/statusline.sh	メインのステータスライン表示
scripts/cron-state.sh	~/.claude/hooks/cron-state.sh	/tmp/claude/loops.json内の/loop cronジョブを追跡
scripts/cron-state-clear.sh	~/.claude/hooks/cron-state-clear.sh	セッション終了時にループの状態をクリア

各スクリプトを scripts/から~/.claude/hooks/にコピーします。差分を表示して確認を得ずに、既存のスクリプトを上書きしてはいけません。

~/.claude/settings.jsonのエントリ

これらを既存の設定にマージします。他のすべてのキーを保持します。重複は作成しません。

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/hooks/statusline.sh"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "CronCreate|CronDelete",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/cron-state.sh",
            "async": true
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/cron-state-clear.sh",
            "async": true
          }
        ]
      }
    ]
  }
}

制約

• .claude/（プロジェクトローカル）ではなく、~/.claude/hooks/（ユーザー全体）に書き込みます
• 差分を表示して確認を得ずに、既存のスクリプトを上書きしてはいけません
• ~/.claude/settings.jsonの既存のキーを破棄してはいけません
• 必要なもの：jq、curl、python3、git（いずれもmacOS／Linuxの標準ツールです）
• 5h／7dの使用状況セクションにはClaude Pro／MaxのOAuthセッションが必要です。トークンが見つからない場合は、通知なしで省略されます
• インストール後、statusLineとフックを有効にするにはClaude Codeを再起動してください