# ox conversation (https://sageox.ai/docs/cli/conversation)

# 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

<Terminal>
  <TerminalCommand>ox conversation [command]</TerminalCommand>
</Terminal>

## 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

<Terminal>
  <TerminalCommand>ox conversation list --limit 5</TerminalCommand>
</Terminal>

Browse the active team's recent conversations, newest first, with the ids, title, date, and participants needed to descend a rung.

<Terminal>
  <TerminalCommand>ox conversation show cnv_01hxyz</TerminalCommand>
</Terminal>

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.

<Terminal>
  <TerminalCommand>ox conversation topics cnv_01hxyz</TerminalCommand>
</Terminal>

List the distillation topics for a conversation: one row per topic with its title, summary, atom count, and citation URIs.

<Terminal>
  <TerminalCommand>ox conversation transcript cnv_01hxyz --cues 1-100</TerminalCommand>
</Terminal>

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](/docs/cli/query) - Semantic search across discussions and sessions
- [Team Context](/docs/features/team-context) - The team-wide conversation store these commands read from
- [Discussions](/docs/context-capture/discussions) - How recorded human conversations are captured