mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-01 06:23:28 +08:00
63 lines
2.0 KiB
Markdown
63 lines
2.0 KiB
Markdown
---
|
|
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:
|
|
|
|
```bash
|
|
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.
|
|
|
|
## 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
|