statusline

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