Commands by group

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

Scenario status and lifecycle

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

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

Micros

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

Databases

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

Mocks

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

Custom startup

microlab run show <id> | set <id> [options] | clear <id> | preview <id>
microlab 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

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

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

Docker, catalog bundle and daemon

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

Diagnostics, consent and self-discovery

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

See also

• The CLI at a glance · Typical flows · MCP