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.
• --exit-code with --watch requires --watch-count so watchdog scripts do not wait forever for a process exit.
• 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.
• ecc loop-status --watch --write-dir ~/.claude/loops maintains index.json and per-session JSON snapshots for sibling terminals or watchdog scripts.

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.

Snapshot Files

Use --write-dir <dir> when a separate process needs to inspect loop state without waiting for the current Claude session to dequeue /loop-status. The CLI writes:

• index.json with one row per inspected session.
• <session-id>.json with the full status payload for that session.

These files are snapshots of local transcript analysis. They do not control or timeout Claude Code runtime tool calls.

Arguments

$ARGUMENTS:

• --watch optional