Ralph Status
Trigger: /ralph-status
Claude CodeGeneric
# Ralph Worktree Status Dashboard
**Trigger**: `/ralph-status`
Show the status of all Ralph autonomous worktrees.
## Steps
1. **Establish repo root and list all worktrees**:
```bash
REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
PROJECT_NAME=$(basename "$REPO_ROOT")
BASE_DIR=$(dirname "$REPO_ROOT")
# Robust default branch detection
DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@')
[ -z "$DEFAULT_BRANCH" ] && git remote set-head origin --auto 2>/dev/null && DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@')
DEFAULT_BRANCH="${DEFAULT_BRANCH:-main}"
cd "$REPO_ROOT"
git worktree list
- For each Ralph worktree (branch matches
ralph/*):
Gather and display:
WORKTREE="$BASE_DIR/$PROJECT_NAME-ralph-$NAME"
# Branch name
git -C "$WORKTREE" branch --show-current
# Commit count ahead of default branch
git -C "$WORKTREE" rev-list --count "origin/$DEFAULT_BRANCH..HEAD"
# Last commit message and time
git -C "$WORKTREE" log --oneline -1
git -C "$WORKTREE" log -1 --format="%cr"
# Working tree status (clean vs dirty)
git -C "$WORKTREE" status --short | wc -l
# Check for RALPH_LOG.md (blocker documentation)
test -f "$WORKTREE/RALPH_LOG.md" && echo "Has RALPH_LOG.md"
# Check diff stats against default branch
git -C "$WORKTREE" diff --stat "origin/$DEFAULT_BRANCH..HEAD" | tail -1
- Format as a dashboard table:
Ralph Worktree Status
=====================
| Worktree | Branch | Commits | Last Activity | Status | Notes |
|----------|--------|---------|---------------|--------|-------|
| exception-hardening | ralph/exception-hardening | 12 | 2 hours ago | Clean | +340 -89 across 7 files |
| security-config | ralph/security-config | 8 | 30 min ago | Dirty | Has RALPH_LOG.md |
| pyjwt-migration | ralph/pyjwt-migration | 0 | (not started) | Clean | |
- Show summary with:
- Total Ralph worktrees
- Total commits across all
- Any worktrees with RALPH_LOG.md (potential blockers)
- Suggested next actions (push, review, cleanup)
Maintain Ralph Status?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[Ralph Status on getagentictools](https://getagentictools.com/loops/ulrimi-ralph-worktree-status-dashboard?ref=badge) npx agentictools info loops/ulrimi-ralph-worktree-status-dashboard The second line is the CLI lookup for this page — handy in READMEs and docs.