everything-claude-code/commands/loop-status.md

description

description
Inspect active loop state, progress, failure signals, and recommended intervention.

Loop Status Command

Inspect active loop state, progress, and failure signals.

This slash command can only run after the current session dequeues it. If you need to inspect a wedged or sibling session, run the packaged CLI from another terminal:

npx --package ecc-universal ecc loop-status --json

The CLI scans local Claude transcript JSONL files under ~/.claude/projects/** and reports stale ScheduleWakeup calls or Bash tool calls that have no matching tool_result.

Usage

/loop-status [--watch]

What to Report

• active loop pattern
• current phase and last successful checkpoint
• failing checks (if any)
• estimated time/cost drift
• recommended intervention (continue/pause/stop)

Cross-Session CLI

• ecc loop-status --json emits machine-readable status for recent local Claude transcripts.
• ecc loop-status --home <dir> scans a different home directory when inspecting another local profile or mounted workspace.
• ecc loop-status --transcript <session.jsonl> inspects one transcript directly.
• ecc loop-status --bash-timeout-seconds 1800 adjusts the stale Bash threshold.
• ecc loop-status --exit-code exits 2 when stale loop or tool signals are found, or 1 when transcripts cannot be scanned.
• ecc loop-status --watch refreshes status until interrupted.
• ecc loop-status --watch --watch-count 3 --exit-code refreshes a bounded number of times, then exits with the highest status seen.
• ecc loop-status --watch --watch-count 3 emits a bounded watch stream for scripts and handoffs.

Watch Mode

When --watch is present, refresh status periodically. With --json, each refresh is emitted as one JSON object per line so another terminal or script can consume the stream.

Arguments

$ARGUMENTS:

• --watch optional