ox conversation
Read-only commands for browsing recorded team conversations locally: summaries, transcript slices, and distillation topics, served from the team-context checkout the daemon keeps synced. Works fully logged out, and with no subcommand behaves like ox conversation list.
Commands disclose progressively (list → show → topics → topic → transcript), and each JSON envelope names the next step in its guidance field while token_estimate reports what reading the payload costs.
Accepts three id forms anywhere an <id> is expected: cnv_<uuidv7>, rec_<uuidv7>, or a full sageox:// citation URI copied from a distillation atom.
Usage
Subcommands
| Command | Description |
|---|---|
ox conversation list | List the active team's recorded conversations |
ox conversation show <id> | Show one conversation's metadata and human summary |
ox conversation topics <id> | List a conversation's distillation topics |
ox conversation topic <id> <tp_id> | Show one distillation topic's atoms |
ox conversation transcript <id> | Read a transcript slice by cue range or time window |
Examples
Browse the active team's recent conversations, newest first, with the ids, title, date, and participants needed to descend a rung.
Read one conversation's metadata and human summary. A conversation without a summary yet reports available=false with a typed reason, data, not an error.
List the distillation topics for a conversation: one row per topic with its title, summary, atom count, and citation URIs.
Read a transcript slice by an inclusive 1-based cue range. Use --from/--to for a media-clock window instead, or --full to serve the whole transcript.
Flags
| Flag | Description |
|---|---|
--format string | Output format: json or text |
--limit int | Cap the number of conversations returned |
--since string | Only conversations recorded on or after this instant (RFC3339 or YYYY-MM-DD) |
--text | Shorthand for --format text |
What's next
- ox query - Semantic search across discussions and sessions
- Team Context - The team-wide conversation store these commands read from
- Discussions - How recorded human conversations are captured