groove-admin-claude-statusline

groove-admin-claude-statusline

Install a rich single-line Claude Code statusline. Writes three scripts to ~/.claude/hooks/ and merges config into ~/.claude/settings.json.

Use --uninstall to remove. Use --list to show current status.

Outcome

~/.claude/settings.json has statusLine pointing to the statusline script, plus PostToolUse and SessionEnd hooks to track active /loop cron jobs. The statusline shows on every Claude Code turn.

What the statusline shows

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

Section	Description
Model	Display name of the active model
Repo@branch	CWD folder name, git branch, staged diff +N -N
Tokens	Used / total context, % used
Effort	Current effort level (low / med / high)
5h / 7d	Rate-limit utilisation with reset time (cached 60s)
Loops	Count of active /loop crons + soonest-firing prompt and time

Steps

--list

Read ~/.claude/settings.json. Report whether statusLine is set, and whether each hook script exists in ~/.claude/hooks/. Exit.

--uninstall

Remove statusLine from ~/.claude/settings.json. Remove the three CronCreate|CronDelete / SessionEnd hook entries added by this skill. Do not remove hook scripts (leave for manual cleanup). Report changes. Exit.

Default (install)

1. Create ~/.claude/hooks/ if absent.

2. Write the three scripts below to ~/.claude/hooks/. Never overwrite without showing a diff and confirming.

3. Make all three scripts executable (chmod +x).

4. Read ~/.claude/settings.json (default {}). Merge in the statusLine entry and the two hook entries below. Preserve all other keys. Do not create duplicate entries.

5. Write ~/.claude/settings.json.

6. Report:

   ✓ 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.
   

Scripts

The three shell scripts live in scripts/ per the Agent Skills specification:

Script	Installed to	Purpose
scripts/statusline.sh	~/.claude/hooks/statusline.sh	Main statusline renderer
scripts/cron-state.sh	~/.claude/hooks/cron-state.sh	Tracks /loop cron jobs in /tmp/claude/loops.json
scripts/cron-state-clear.sh	~/.claude/hooks/cron-state-clear.sh	Clears loop state on session end

Copy each script from scripts/ to ~/.claude/hooks/. Never overwrite an existing script without showing a diff and confirming.

~/.claude/settings.json entries

Merge these into the existing settings. Preserve all other keys. Do not create duplicates.

{
  "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
          }
        ]
      }
    ]
  }
}

Constraints

• Write to ~/.claude/hooks/ (user-global), not .claude/ (project-local)
• Never overwrite an existing script without showing a diff and confirming
• Never discard existing keys in ~/.claude/settings.json
• Requires: jq, curl, python3, git (all standard on macOS/Linux)
• The 5h/7d usage section requires a Claude Pro/Max OAuth session; it silently omits if no token is found
• After install: restart Claude Code for the statusLine and hooks to take effect