CLI global flags
JSON input, readable output, field flags and exit codes.
Every command uses the same argument parser. --help is local help; tools provides the session’s live schemas.
Shared flags
| Flag | Behavior |
|---|---|
--help, -h | Show help without requiring a session. |
--text | Readable output, not tool input. |
--json @input.json | Read JSON from a file. |
--json - | Read JSON from stdin. |
--json '…' | Literal JSON; shell quoting is required. |
--field value or --field=value | Supply a schema field; kebab-case becomes camelCase. |
File and stdin input
era records find --json @find.jsonfind.json:
{"type":"customer","q":"Demo","limit":10}PowerShell:
Get-Content -Raw ./find.json | era records find --json -Fields such as items, ids, where, lines, args and rows expect JSON. limit, minutes and depth expect numbers; draft, told and always expect true/false. Never supply a field twice. Arrays become items for create/update/run/approvals and ids for archive; other commands require an object.
Text input versus output
era overview --text
era memory save --text="Check delivery dates for Demo customers" --toldThe first selects readable output; the second sends text to the tool and requests a memory write. Review the scope of a remembered instruction. Quote positional values containing spaces to keep them one argument.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success; still inspect body states such as awaiting approval. |
| 2 | Invalid command or input. |
| 3 | Missing/expired session. |
| 4 | Permission or approval refusal. |
| 5 | Failed or partial operation. |
| 6 | Connection/protocol failure. |
| 7 | Timeout. |
Calls are not automatically retried. Separate completed items in partial results. --url, --token, --workspace and --version are not implemented as shared options; passing arbitrary fields does not turn them into sign-in configuration.
Command reference
Read command-specific fields alongside live tools schemas.