Skip to Content

Reference

JSON output

The --json contract: fields, schemaVersion, NDJSON and errors.

View source

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.

turno help json
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'