Menu
Install the Ratchet statusline into Claude Code settings
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Run agent pairs through phase-gated debates — guided by epic roadmap and current focus
Analyze project and generate tailored agent pairs through codebase analysis and human interview
Tighten the ratchet — analyze all improvement signals and sharpen the system
View or continue an ongoing debate
Manage guards — list, add, run, and override deterministic checks at phase boundaries
Add a new agent pair to an existing Ratchet configuration
| name | ratchet:statusline |
| description | Install the Ratchet statusline into Claude Code settings |
Configure Claude Code to use Ratchet statusline — shows epic progress, milestone/issue counts, discoveries, and blocked issues in your terminal.
/ratchet:statusline # Install the statusline (local settings)
/ratchet:statusline --global # Install to global settings (~/.claude/)
/ratchet:statusline --remove # Remove it and restore default
Find statusline script. Check local, global, then fetch from GitHub:
if [ -f .claude/statusline-ratchet.sh ]; then
STATUSLINE_PATH=".claude/statusline-ratchet.sh"
elif [ -f "$HOME/.claude/statusline-ratchet.sh" ]; then
STATUSLINE_PATH="$HOME/.claude/statusline-ratchet.sh"
else
echo "NOT FOUND LOCALLY"
fi
If not found locally, fetch from GitHub and install to global path:
mkdir -p "$HOME/.claude"
curl -fsSL https://raw.githubusercontent.com/netbrain/ratchet/refs/heads/main/statusline/statusline-ratchet.sh \
-o "$HOME/.claude/statusline-ratchet.sh"
chmod +x "$HOME/.claude/statusline-ratchet.sh"
STATUSLINE_PATH="$HOME/.claude/statusline-ratchet.sh"
If curl fails — STOP. Do NOT create the script yourself. Tell user: "Could not fetch statusline script. Install Ratchet first: nix run github:netbrain/ratchet -- --global or ./install.sh --local" Then stop.
Update settings. Default to local (.claude/settings.json). Use ~/.claude/settings.json only if --global specified. If file doesn't exist, create with just statusline key. If exists, add/update only statusline key — preserve everything else.
{
"statusline": "<STATUSLINE_PATH from step 1>"
}
Use Edit tool to update existing file, or Write to create new.
Confirm: "Ratchet statusline installed. Restart Claude Code to see it."
--remove).claude/settings.json (check local first, then global)statusline key — preserve everything else