@mynd/cli reference
CLI
Every command the CLI ships, in one table.
The CLI wraps the REST API for the workflows you do from a terminal: auth, project scaffolding, runs, traces, and key management. Install with npm install -g @mynd/cli; the binary is `mynd`. All commands accept --json for machine-readable output and respect MYND_API_KEY over the stored session.
Commands
| command | what it does |
|---|---|
| mynd auth login | Browser-based login; stores a session in ~/.mynd. |
| mynd auth status | Shows the active project, key, and scopes. |
| mynd init <name> | Scaffolds a project — config, sandbox key, example run. |
| mynd run "<prompt>" | Creates a run from the terminal; streams the trace live. |
| mynd runs list | Recent runs with status, model, and steps used. |
| mynd traces export <id> | Writes a run's full trace to stdout as JSON. |
| mynd traces replay <file> | Replays exported traces; --fail-on-diff for CI. |
| mynd keys create --scopes <s> | Mints a key with exactly the scopes listed. |
| mynd keys rotate <id> | Creates a successor key and schedules revocation. |
| mynd webhooks tail | Streams live webhook events to your terminal for debugging. |
| mynd status | Current platform status — same data as /status. |
Exit codes
- 0 — success
- 1 — API error; the error body is printed to stderr as JSON
- 2 — usage error; bad flags or missing arguments
- 3 — auth error; no session and no MYND_API_KEY