rses

Cross-resume between Claude Code, Codex CLI, and OpenCode. Pick up where one AI coding agent left off — in another.

rses claude with codex --last

That's it. Claude launches with full context from your last Codex session: the original task, git diff, conversation history, and a pointer to the session file for deep-dive.

Works in all 6 directions between Claude Code, Codex CLI, and OpenCode.

Install

npm i -g rses-cli

Node.js 22+ required (uses built-in SQLite).

Quick start

# You were working in Codex. Now you want Claude to continue.
rses claude with codex --last

# Or the other way around.
rses codex with claude --last

# OpenCode works too — any combination.
rses opencode with codex --last
rses claude with opencode --last

What it does

1. Reads the source tool's session data (JSONL files or SQLite)
2. Extracts: original task, git log since session start, working tree status, last N conversation turns
3. Includes a pointer to the full session file so the receiving model can Read it for complete history
4. Launches the target tool with a structured handoff prompt as the first message

The receiving model is oriented on turn one. No re-explaining.

Commands

Handoff (main command)

rses <target> with <source> [session-id] [flags]

# Examples
rses claude with codex --last                    # most recent Codex session
rses codex with claude ses_46f04b499ffe...       # specific Claude session
rses opencode with codex                         # interactive picker
rses claude with codex --last --dry-run           # print handoff, don't launch

List sessions

rses ls                    # all tools
rses ls codex              # just Codex
rses ls claude             # just Claude
rses ls opencode           # just OpenCode
rses ls codex --dir .      # filter by working directory

Export

rses export codex <id>           # print handoff to stdout
rses export claude <id> --turns 10

Aliases

Power-user shorthand — type less, ship faster:

| Alias | Expands to | |-------|-----------| | cc, cl, c | claude | | cdx, cx, x | codex | | oc, o | opencode | | w | with |

rses cc w cdx --last          # same as: rses claude with codex --last
rses x w oc --last            # same as: rses codex with opencode --last
rses ls cx                    # same as: rses ls codex

Flags

| Flag | Description | |------|-------------| | --last | Use most recent session (no picker, no ID needed) | | --dry-run | Print the handoff text without launching | | --dir <path> | Filter sessions by working directory | | --turns <n> | Number of conversation turns to include (default: 6) |

Everything else is passed through to the target tool:

rses claude with codex --last --dangerously-skip-permissions --model opus
rses codex with claude --last --model o3-pro
rses opencode with claude --last --provider anthropic

How sessions are read

| Tool | Source | Upgrade-safe | |------|--------|-------------| | Claude Code | ~/.claude/transcripts/ses_*.jsonl | Reads only user/assistant types | | Codex CLI | ~/.codex/state_*.sqlite (auto-discovers version) + JSONL fallback | Handles both 2025 and 2026 schemas | | OpenCode | ~/.local/share/opencode/opencode.db | Single JOIN query, reads stable columns only |

All parsers are read-only and wrapped in try/catch — if a tool changes its format, rses degrades gracefully instead of crashing.

Requirements

• Node.js 22+ (for built-in node:sqlite)
• At least one of: Claude Code, Codex CLI, OpenCode
• macOS or Linux (Windows support planned)

License

MIT