txcript CLI
txcript moves a session from Claude Code to Codex, OpenCode or Cursor with its messages, reasoning and tool-call history
- 220 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- Reads the local history of every supported agent, and a JSON export holds the whole conversation
- Writes new native sessions into other agents' storage and launches the target agent
Install
- Works in
Manual install
cargo install --git https://github.com/skillsynchq/txcript txcript-cli --lockedNeeds Rust 1.96 or newer. Prebuilt binaries for macOS, Linux and Windows are on the releases page.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads the local history of every supported agent, and a JSON export holds the whole conversation
- Writes new native sessions into other agents' storage and launches the target agent
This is third-party code. Review the repository files before installing.
What it does
txcript is a Rust command-line tool and library for converting AI agent sessions. A conversation started in Claude Code can continue in Codex: txcript writes a new native session with messages, reasoning and tool history wherever the target agent understands them, and launches that agent in the recorded working directory. The source session is kept. The main flow is two commands: `txcript list --from claude_code` finds a session and `txcript continue <id> --with codex` moves it. Beyond that come search over local history with `txcript query`, terminal viewing with `view`, trimming or editing history into a new copy with `crop` and JSON export with `export`. The `run.json` file can move to another machine and continue there, with the project copied separately. The `txcript mcp` command starts a read-only MCP server: a client lists, searches and reads past sessions. Libraries exist for Rust (`cargo add txcript`) and JavaScript (`npm install txcript` with WebAssembly for Node and Bun). Supported agents include Claude Code, Codex, OpenCode, Cursor CLI and the Cursor app, pi, Grok CLI, Antigravity and more, and Hermes Agent can be read without a way back.
Who it is for. Developers who run several agents and want to switch between them mid-task, for example when Claude Code hits a limit, without retelling the context.
Good fit when
- One agent hit its limit mid-task and you need to continue in another agent
- You need to find a session by a phrase such as "relay bug" across several agents' history
- A conversation must pass to a colleague on another machine as a `run.json` file
- Part of the history became noise and you need a trimmed copy of the session
- An app needs one transcript format for Claude Code, Codex and OpenCode: the Rust crate or npm package fits
Not a fit when
- You need the project files moved: txcript moves the conversation and the project is copied separately
- The target agent is not installed or not signed in: it must be ready before a move
- You need a move out of Hermes Agent: reading from it works, writing back does not
- You need real-time session sync: the tool works on command
Example request
Find the latest Claude Code session for this project and continue it in Codex with txcriptLimitations
- The move covers messages, reasoning and tool history only where the target format supports them. What is lost for each agent pair is described in the formats documentation.
- The target agent must be installed and signed in before `txcript continue`.
- Installing from source needs Rust 1.96 or newer, otherwise take prebuilt binaries for macOS, Linux and Windows from releases.
- An export file holds the whole conversation, so send it carefully: the project does not travel with it.
How to disable. Delete the txcript binary or run `cargo uninstall txcript-cli` if you installed through cargo. Sessions created by a move stay in the target agents' storage and are deleted with the agent's own tools. The MCP server runs only while the `txcript mcp` command is running.
FAQ
How do I continue a Claude Code session in Codex?
Run `txcript list --from claude_code`, take the session ID and run `txcript continue <id> --with codex`. An unambiguous ID prefix works too. The source session is kept.
Which agents are supported?
Claude Code, Codex, OpenCode, Cursor CLI and the Cursor app, pi, Campfire, Cowork, Grok CLI, fx and Antigravity can be read and receive sessions. Hermes Agent is read-only.
Can I search session history?
Yes, `txcript query "relay bug"` searches local history, and `txcript mcp` serves the same search to an MCP client, read-only.
How do I move a session to another machine?
Export it with `txcript export <id> --out run.json`, move the file and run `txcript continue ./run.json --with claude_code`. Project files must be moved separately.
Is there a library for my own app?
Yes, the Rust crate installs with `cargo add txcript` and the JavaScript package with `npm install txcript`. The package ships prebuilt WebAssembly for Node and Bun and works on session text in memory.
Discussion
No questions or reviews yet.
Related
CLI toolsCLI and /trajex skill: Claude Code, Codex and Pi sessions in one SQLite index that an agent queries with JS
A CLI that hands session context between coding agents: continue a Claude Code session in Codex, Cursor, OpenCode and others.
Meeting notes on Mac and an MCP for agents: Markdown transcripts, search, recaps and action items, with no bot joining the call
A CLI that gathers Claude Code and Codex session history into a local graph, searches it and turns repeated mistakes into fixes
claude-history searches and opens past Claude Code, Codex and Pi conversations in the terminal and gives Claude a history skill
An MCP server and CLI that find in Claude Code and Codex sessions why a file became what it is: who asked the agent what, when and what changed
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| txcript (this card) | no | 220 | |
| Coding Agent Session Search (cass) | no | 1,205 | searches session history but does not move sessions between agents |
| Claude Code History Viewer | no | 2,314 | a desktop history viewer with no continuation in another agent |
README in short
The README states the purpose in two paragraphs and lets you try the CLI right away: install, move a session and extra commands. It then shows Rust and JavaScript library examples, a table of supported agents with read and receive marks, and links to format documentation.