For agents
JSON output, a price before every run, and a schema for every command.
JSON output
Pass --format json for one object on stdout. Errors arrive as one object on stderr.
motif "amber bottles and a brass dish on a walnut shelf" --format json --no-openPrice a run first
--dry-run reports the cost before anything is spent. A cost of null means the total is unknown, not free.
motif erase "the parked car" street.jpg --dry-run --fields cost,costBasis,outputErrors and exit codes
The exit code and the error object always agree, so branch on the code.
| Exit | Meaning | Error codes |
|---|---|---|
| 0 | Success | |
| 2 | Invalid input or usage | INVALID_OPTION |
| 2 | No Model can do it | NO_MODEL_AVAILABLE |
| 3 | Key missing or refused | MISSING_API_KEY |
| 4 | Not found | NO_PREVIOUS |
| 5 | The provider failed | TASK_FAILED |
Read the schema
Read one command’s schema before you call it.
motif --describe erase --format jsonDocs for agents
| llms.txt | A plain-text index of every page. |