/loop-status

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