JSON output
The --json contract: fields, schemaVersion, NDJSON and errors.
This page is the contract of --json, for scripts that read turno's output. Commands that only read take --json; turno help json prints the same text.
JSON output. Read commands take --json:
--json every field, as one indented document
--json=fields the field names, one per line, and nothing else
--json=a,b only those fields; an unknown one is a usage error (exit 2)
that lists the known ones
--watch --json one compact JSON record per line (NDJSON) until Ctrl-C (turno
limit show, turno mcp top); turno mcp log --follow --json too
Every object carries schemaVersion, and so does each element of a list. A version
goes up only when a field is removed or renamed or changes meaning (the changelog
says so); new fields keep it. Errors under --json are JSON on stderr (turno help
exit-codes). turno config get prints a config value as it is in config.toml.
Examples:
$ turno status --json=fields
$ turno profile list --json=name,email
$ turno limit show --watch --json | jq -c '.fiveHour'