txcript is a library for converting agent sessions. Start a conversation in Claude Code and continue it in Codex, carrying over messages, reasoning, and tool history where the target supports them.
Build session search, viewers, and editors against one transcript model. txcript handles the agent-specific formats, with a Rust API, a JavaScript package, and a CLI.
Try the CLI · Use the library · Supported agents · Documentation
Try the CLI
Download a binary for macOS, Linux, or Windows from Releases, or install from source with Rust 1.96 or newer:
cargo install --git https://github.com/skillsynchq/txcript txcript-cli --locked
Find a Claude Code session and continue it in Codex:
txcript list --from claude_code
txcript continue <session-id> --with codex
Use an ID from the list; an unambiguous prefix works too. txcript writes a new native session and launches Codex in the recorded working directory. The source session is kept. Have the target agent installed and signed in before continuing.
Other ways to work with your sessions:
txcript query "relay bug" # search local session history
txcript view <session-id> # read a conversation in the terminal
txcript crop <session-id> # edit or trim history into a new copy
txcript export <session-id> --out run.json
Move run.json to another machine and continue it with txcript continue ./run.json --with claude_code. Bring the project files separately.
Run txcript mcp to let an MCP client list, search, and read past sessions. Its tools are read-only. See the CLI reference for filters, message ranges, and shell integration.
Use the library
Rust
cargo add txcript
Convert a Claude Code transcript into Codex's native format:
use txcript::harness::{claude_code::ClaudeCode, codex::Codex};
use txcript::{TextCodec, convert};
fn main() -> Result<(), Box<dyn std::error::Error>> {
let input = std::fs::read_to_string("session.jsonl")?;
let source = ClaudeCode::from_text(&input)?;
let target = convert::<ClaudeCode, Codex>(&source)?;
std::fs::write("rollout.jsonl", Codex::to_text(&target)?)?;
Ok(())
}
Use Store implementations to discover, load, and save sessions in an agent's own storage. Convert to Transcript<Common> to search, crop, or render conversations through the same API across agents. See the Rust API and examples.
JavaScript
npm install txcript
import { convert } from "txcript";
import { readFileSync, writeFileSync } from "node:fs";
const input = readFileSync("session.jsonl", "utf8");
const output = convert(input, "claude_code", "codex");
writeFileSync("rollout.jsonl", output);
The package includes prebuilt WebAssembly for Node and Bun. It converts and searches session text in memory; your application handles files and storage. See the JavaScript reference.
Supported agents
Each name links to its format documentation. Use the ID with --from and --with.
Local discovery skips the live accounts. Select --from claude_chat, --from cowork_remote, or --from chatgpt explicitly to read them. These sources use private web APIs and reuse an existing app login; requirements and limitations are in their linked docs.
Bring another agent
An agent without a native adapter can emit Simple, txcript's interchange JSON. Save a document like this as run.json:
{
"messages": [
{ "role": "user", "content": "Find why the tests fail." },
{ "role": "assistant", "content": "The test clock is using local time." }
]
}
txcript continue ./run.json --with claude_code
Simple also represents reasoning, tool calls, results, images, and metadata. It is the format txcript export writes.
What carries over
The common model represents messages, reasoning, tool calls and results, images, metadata, and token usage. What survives conversion depends on what the source records and the destination can represent. Agent-specific records and unsupported fields can be lost.
Conversion carries conversation history. The destination supplies its own system instructions and tools, and project files must be available separately. Native load/save and conversion have different preservation guarantees; see each format's caveats.
Documentation
License
Apache-2.0
