Commands by group

All commands accept --json and -p <path>. Add -h to any of them for its full help.

Scenario status and lifecycle

aseptic status                      # live engine, Docker, active scenario and micros
aseptic doctor [scenario]           # environment check before launching
aseptic start <scenario> [flags]    # starts (launches daemon if needed) and waits healthy
aseptic stop                        # stops the active scenario
aseptic restart <micro>             # restarts a single micro
aseptic metrics [micro]             # last metrics sample (--json = history)
aseptic set-resolution <dep> <local|dev|mock>   # changes the resolution hot
aseptic cleanup [scenario]          # defensive cleanup (orphans, ports)
aseptic prep <scenario> --when <pre-boot|post-migrate>
aseptic logs [micro] [-f] [-n N] [--errors] [-g pattern]
aseptic call <micro> [path] [-X method] [-d body] [-H k=v...]
aseptic diagnose <micro> [-n N]     # what's wrong with a micro, in one shot

Flags for start: -r/--resolve <dep=mode> (one-off resolution override), -m/--mode <micro=mode> (native|container), --no-wait, --no-docker, --timeout <s> (default 600). start starts Docker on its own unless --no-docker.

Scenarios

aseptic scenario list | show <n> | graph <n> | save --file <yml> | delete <n>
aseptic scenario export <n> [-o file] [--include-run]
aseptic scenario import <file> [--apply] [policies]

Micros

aseptic service list | show <id> | add <repo-path> | save --file <yml> | delete <id>
aseptic service export <id> [--include-run] | import <yml...>
aseptic service drift <id>          # does the manifest diverge from the repo? (exit 1 if drift)
aseptic service rescan <id>         # reconciles from the repo (preserves curation)

Databases

aseptic db list | save --file <yml> | delete <id>
aseptic db test <host> <port>       # TCP reachability (exit 1 if no response)

Mocks

aseptic mock services | catalog [service] | calls | events | clear-calls
aseptic mock save <service> --file <json> | delete <service> --method GET --path /x
aseptic mock set-active <service> --method GET --path /x --variant 1
aseptic mock enable|disable <service> --method GET --path /x
aseptic mock operations <service> | skeleton <service> <method> <path>
aseptic mock from-call <method> <path> | probe <method> <path>
aseptic mock export|import <service> [file] | export-all|import-all [file]

Custom startup

aseptic run show <id> | set <id> [options] | clear <id> | preview <id>
aseptic run export <id> [-o file] | import <id> <file>

run set accepts --profile, --prop k=v, --toggle <id>, --extra-args, --command, --datasource-ref <id>, --datasource local|dev|custom [--url ...].

Settings

aseptic config show | get <key> | set <key> <value> | unset <key>

Keys: workspace, composeFile (bundled or path), mockPort, credentials.<name>.

Docker, catalog bundle and daemon

aseptic docker status | start [--no-wait] [--timeout <s>]
aseptic containers | docker-clean | infra <n> | infra-up <n> | infra-down
aseptic bundle export [-o file] | import <file> [--overwrite]
aseptic daemon start | stop | status

Diagnostics, consent and self-discovery

aseptic telemetry info | on | off | test [--note <text>]
aseptic consent info | history
aseptic ops [--json]                # the engine's complete surface
aseptic mcp                         # starts the MCP server over stdio

See also

• The CLI at a glance · Typical flows · MCP