Skip to main content
Three read verbs for observing your clones. status reads the registry only (no Docker needed); doctor reconciles it against Docker; logs streams from the container.

​
status

Lists every clone from the registry, one tab-separated line each: id, template, mode, state, and its environment (derived from membership, - if none).
Empty registry:
For environments specifically, use hone env status.

​
Options

​
logs

Streams a clone’s container logs to stdout.

​
Options

​
doctor

Reconciles the registry against Docker and reports: where state lives, whether Docker and the shared Postgres are up, counts of clones and environments, and a per-clone reconciliation (recorded state vs what Docker actually reports). It also surfaces orphan containers — containers labeled asym.clone=<id> that the registry has never heard of (a spin killed mid-flight). --fix prunes orphaned registry entries, corrects drifted states, and reconciles environment states.
A clone whose containers vanished outside the CLI shows ✗ orphaned; an orphan container with no registry entry is listed separately. doctor exits non-zero when issues remain, so it’s useful in CI. Plain --fix deliberately leaves orphan containers alone (reaping them is destructive), so they still count as issues in CI. To also remove those containers and drop their databases, add --reap-orphans — it requires --fix and errors (exit 1) if passed without it.

​
Options

Run doctor first whenever something looks off — it’s read-only without --fix and tells you exactly where the registry and Docker disagree.