Groundwork Statusline

Configure Groundwork's optional statusline only after the user explicitly invokes this workflow.

Use the supplied action, install or uninstall. When no action is supplied, default to install. Reject any other action and show /groundwork:statusline [install|uninstall].

Install

The renderer asset is ${CLAUDE_PLUGIN_ROOT}/statusline-command.sh. Claude Code does not expand ${CLAUDE_PLUGIN_ROOT} inside a user statusLine command, and marketplace installs are versioned. Install a stable wrapper at $HOME/.claude/groundwork-statusline.sh so future plugin upgrades use the newest installed Groundwork plugin version.

1. Before modifying any file, verify the renderer's hard dependencies. Run command -v jq and command -v curl. If either command is missing, stop and report which dependency must be installed. gh is optional and only adds pull-request information.

2. Resolve the absolute home directory, the current plugin root, and the current plugin versions directory:

   HOME_DIR="$HOME"
   PLUGIN_ROOT="$CLAUDE_PLUGIN_ROOT"
   VERSIONS_DIR="$(dirname "$CLAUDE_PLUGIN_ROOT")"

3. Read $HOME/.claude/settings.json, treating a missing file as {}. Inspect its statusLine value.
   • If it already invokes $HOME/.claude/groundwork-statusline.sh, Groundwork owns it; continue so the wrapper is refreshed.
   • If a different statusLine exists, ask the user before replacing it. Stop without modifying settings or the wrapper when they decline.

4. Write this executable wrapper, substituting the resolved absolute <VERSIONS_DIR> and <PLUGIN_ROOT>:

   #!/usr/bin/env bash
   # Auto-generated by /groundwork:statusline.
   base="<VERSIONS_DIR>"
   fallback="<PLUGIN_ROOT>/statusline-command.sh"
   latest=$(ls -1 "$base" 2>/dev/null | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | sort -t. -k1,1n -k2,2n -k3,3n | tail -1)
   script="$base/$latest/statusline-command.sh"
   if [ -n "$latest" ] && [ -f "$script" ]; then
     exec bash "$script"
   elif [ -f "$fallback" ]; then
     exec bash "$fallback"
   fi

   Then run chmod +x "$HOME/.claude/groundwork-statusline.sh".

5. Add or replace only statusLine in $HOME/.claude/settings.json, preserving all unrelated settings. Substitute the resolved absolute <HOME_DIR>; do not use ~:

   "statusLine": {
     "type": "command",
     "command": "bash <HOME_DIR>/.claude/groundwork-statusline.sh",
     "height": 3
   }

6. Report that installation is complete and Claude Code must be restarted to display it.

Uninstall

1. Read $HOME/.claude/settings.json. If no statusLine exists, report that nothing is configured and stop.
2. Groundwork owns the setting only when its command invokes $HOME/.claude/groundwork-statusline.sh.
3. If another command is configured, leave both it and the wrapper untouched and report that Groundwork does not own the active statusline.
4. For an owned setting, remove only the statusLine key while preserving all unrelated settings. Then remove the wrapper. In other words, remove the wrapper only when Groundwork owns the configured statusLine.
5. Report that removal is complete and Claude Code must be restarted to apply it.