# ox record (/docs/cli/record)



ox record [#ox-record]

Capture transcripts from AI coding sessions. When you work with Claude Code, Cursor, or Aider, the conversation contains valuable decisions and domain knowledge. `ox record` saves these to your repo's Ledger.

**Important:** This captures text-based human-AI coding sessions, not audio/video meetings. For meeting recordings, see [Discussions](/docs/context-capture/discussions).

What Gets Recorded [#what-gets-recorded]

* Questions and context you provided
* Code suggestions and explanations
* Decisions made and alternatives discussed
* Debugging and problem-solving approaches

Commands [#commands]

Create a Recording [#create-a-recording]

<Terminal>
  <TerminalCommand>
    ox record create [flags]
  </TerminalCommand>
</Terminal>

| Flag                  | Description                                |
| --------------------- | ------------------------------------------ |
| `--title`, `-t`       | Title for the recording                    |
| `--description`, `-d` | Optional description                       |
| `--path`, `-p`        | Path to transcript file                    |
| `--agent-type`        | AI agent type (claude-code, cursor, aider) |

<Terminal>
  <TerminalComment>
    Pipe transcript
  </TerminalComment>

  <TerminalCommand>
    cat session.md | ox record create --title "Auth refactor"
  </TerminalCommand>

  <TerminalComment>
    From file
  </TerminalComment>

  <TerminalCommand>
    ox record create --title "API design" --path ./transcript.md
  </TerminalCommand>
</Terminal>

List Recordings [#list-recordings]

<Terminal>
  <TerminalCommand>
    ox record list [--limit N] [--json]
  </TerminalCommand>
</Terminal>

View a Recording [#view-a-recording]

<Terminal>
  <TerminalCommand>
    ox record view <recording-id> [--json]
  </TerminalCommand>
</Terminal>

Delete a Recording [#delete-a-recording]

<Terminal>
  <TerminalCommand>
    ox record delete <recording-id> [--force]
  </TerminalCommand>
</Terminal>

When to Record [#when-to-record]

* Architectural decisions
* Complex debugging sessions
* Domain knowledge explanations
* Onboarding context
* Novel solutions

Privacy [#privacy]

* Recordings are stored in your repo's Ledger
* Team members with repo access can view them
* Remove sensitive data before recording

Related Commands [#related-commands]

* [ox init](/docs/cli/init) - Initialize your repository