claude-code-vertical/commands/vertical-status.md

description	argument-hint
Check status of plans and weavers. Shows tmux sessions, weaver progress, and PRs.	plan-id

/status Command

Check the status of plans and weavers.

Usage

/status                     # All plans
/status plan-20260119-1430  # Specific plan

What You Do

When /status is invoked:

Without Arguments (All Plans)

# List active tmux sessions
echo "=== Active Tmux Sessions ==="
tmux list-sessions 2>/dev/null | grep "^vertical-" || echo "No active sessions"
echo ""

# List plan statuses
echo "=== Plan Status ==="
if [ -d ".claude/vertical/plans" ]; then
  for plan_dir in .claude/vertical/plans/*/; do
    if [ -d "$plan_dir" ]; then
      plan_id=$(basename "$plan_dir")
      state_file="${plan_dir}run/state.json"
      
      if [ -f "$state_file" ]; then
        status=$(jq -r '.status // "unknown"' "$state_file" 2>/dev/null)
        echo "  ${plan_id}: ${status}"
      else
        meta_file="${plan_dir}meta.json"
        if [ -f "$meta_file" ]; then
          echo "  ${plan_id}: ready (not started)"
        else
          echo "  ${plan_id}: incomplete"
        fi
      fi
    fi
  done
else
  echo "  No plans found"
fi

Output:

=== Active Tmux Sessions ===
vertical-plan-20260119-1430-orch
vertical-plan-20260119-1430-w-01
vertical-plan-20260119-1430-w-02
vertical-plan-20260119-1445-orch

=== Plan Status ===
  plan-20260119-1430: running
  plan-20260119-1445: running
  plan-20260119-1400: complete

With Plan ID (Specific Plan)

plan_id="$1"
plan_dir=".claude/vertical/plans/${plan_id}"

# Validate plan exists
if [ ! -d "$plan_dir" ]; then
  echo "Error: Plan not found: ${plan_id}"
  exit 1
fi

# Read state
state_file="${plan_dir}/run/state.json"
if [ -f "$state_file" ]; then
  status=$(jq -r '.status // "unknown"' "$state_file")
  started=$(jq -r '.started_at // "-"' "$state_file")
else
  status="ready (not started)"
  started="-"
fi

echo "=== Plan: ${plan_id} ==="
echo "Status: ${status}"
echo "Started: ${started}"
echo ""

# List specs
echo "=== Specs ==="
for spec in "${plan_dir}/specs/"*.yaml; do
  [ -f "$spec" ] && echo "  $(basename "$spec")"
done
echo ""

# List weaver status
echo "=== Weavers ==="
weavers_dir="${plan_dir}/run/weavers"
if [ -d "$weavers_dir" ]; then
  for weaver_file in "${weavers_dir}"/*.json; do
    if [ -f "$weaver_file" ]; then
      w_name=$(basename "$weaver_file" .json)
      w_status=$(jq -r '.status // "unknown"' "$weaver_file" 2>/dev/null)
      w_spec=$(jq -r '.spec // "?"' "$weaver_file" 2>/dev/null)
      w_pr=$(jq -r '.pr // "-"' "$weaver_file" 2>/dev/null)
      printf "  %-10s %-15s %-30s %s\n" "$w_name" "$w_status" "$w_spec" "$w_pr"
    fi
  done
else
  echo "  No weavers yet"
fi
echo ""

# List tmux sessions for this plan
echo "=== Tmux Sessions ==="
tmux list-sessions 2>/dev/null | grep "vertical-${plan_id}" | while read line; do
  session_name=$(echo "$line" | cut -d: -f1)
  echo "  ${session_name}"
done || echo "  No active sessions"

Output:

=== Plan: plan-20260119-1430 ===
Status: running
Started: 2026-01-19T14:35:00Z

=== Specs ===
  01-schema.yaml
  02-backend.yaml
  03-frontend.yaml

=== Weavers ===
  w-01       complete        01-schema.yaml                 https://github.com/...
  w-02       verifying       02-backend.yaml                -
  w-03       waiting         03-frontend.yaml               -

=== Tmux Sessions ===
  vertical-plan-20260119-1430-orch
  vertical-plan-20260119-1430-w-01
  vertical-plan-20260119-1430-w-02

Weaver Status Reference

Status	Meaning
waiting	Waiting for dependency to complete
building	Implementing the spec
verifying	Running verification checks
fixing	Fixing verification failures
complete	PR created successfully
failed	Failed after max iterations
blocked	Dependency failed
crashed	Session terminated unexpectedly

Quick Actions

Based on status, suggest actions:

Status	Suggested Action
complete	gh pr list to review PRs
running	tmux attach -t <session> to watch
failed	claude --resume <session-id> to debug
ready	/build <plan-id> to start

Viewing Results

# Summary (after completion)
cat .claude/vertical/plans/<plan-id>/run/summary.md

# State JSON
cat .claude/vertical/plans/<plan-id>/run/state.json | jq

# Specific weaver
cat .claude/vertical/plans/<plan-id>/run/weavers/w-01.json | jq

# List PRs
gh pr list

Tmux Helper Commands

# Source helpers
source lib/tmux.sh

# List all vertical sessions
vertical_list_sessions

# Full status
vertical_status

# Weaver status for a plan
vertical_weaver_status plan-20260119-1430

# Capture recent output
vertical_capture_output vertical-plan-20260119-1430-w-01

# Attach to a session
vertical_attach vertical-plan-20260119-1430-w-01