TAI42 — the OS for AI tools

List and inspect run traces.

$ tai traces [OPTIONS] COMMAND [ARGS]...

`tai traces capabilities`

Show what the monitoring backend serves: the page maximum, the sorts and the sort/filter combinations. Example: tai traces capabilities

$ tai traces capabilities [OPTIONS]

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

Get one run’s full trace, or download it as JSON with --export. Example: tai traces get trace_abc

$ tai traces get [OPTIONS] {trace_id}

Argument	Description
`trace_id`	Trace id. (required)

Option	Description
`--export`	Download the full trace as a JSON file instead. (default: `False`)
`--json` / `--no-json`	Emit raw JSON instead of human tables.

List observability runs, or download the filtered list with --export. Example: tai traces list --status error --sort cost

$ tai traces list [OPTIONS]

Option	Description
`--from` `<str>`	Range start: an ISO instant or a relative token (30d).
`--to` `<str>`	Range end: an ISO instant or a relative token.
`--status` `<str>`	Filter: ‘error’ or ‘success’.
`--sort` `<str>`	Sort field: createdAt, cost, latencyMs, totalTokens.
`--dir` `<str>`	Sort direction: asc or desc.
`--page` `<int>`	Page number (1-based).
`--page-size` `<int>`	Rows per page.
`--export`	Download the filtered list instead of paging it. (default: `False`)
`--format` `<str>`	Export format: csv or json (only with —export). (default: `csv`)
`--user` `<str>`	Filter: runs stamped with this user identity.
`--session` `<str>`	Filter: runs stamped with this session identity.
`--version` `<str>`	Filter: runs stamped with this trace version dimension.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

Get one run’s span tree: every span with its parent, kind, status and metadata, without input/output. Example: tai traces outline trace_abc

$ tai traces outline [OPTIONS] {trace_id}

Argument	Description
`trace_id`	Trace id. (required)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

Read one span field’s value with every record reference resolved. Example: tai traces value trace_abc span_1 --field output --pointer /outputs/n

$ tai traces value [OPTIONS] {trace_id} {span_id}

Argument	Description
`trace_id`	Trace id. (required)
`span_id`	Span (observation) id. (required)

Option	Description
`--field` `<str>`	The span field: input or output. (default: `input`)
`--pointer` `<str>`	RFC 6901 JSON pointer into the field (e.g. /messages/0).
`--json` / `--no-json`	Emit raw JSON instead of human tables.