Session Porter

session-porter

  Move AI coding sessions between Claude Code and Codex CLI without losing context.
  Local-only JSONL conversion. No cloud service. No API keys.

  Install •
  Quick Start •
  Commands •
  Architecture •
  Safety

Both tools store sessions as JSONL files on disk. session-porter reads, normalizes, and converts between them — so you can start a conversation in Claude Code and continue it in Codex (or vice versa).

Install

Or clone and link:

Quick Start

Commands

list — Browse sessions

show — Read a session transcript

Session IDs are prefix-matched — first 8 characters are enough.

summary — Quick session overview

Shows turn counts, tool operations, files touched, and token usage.

export — Convert to a file format

transfer — Move a session to another agent

Transfer writes the converted session directly into the target tool's session directory and registers it in the Codex SQLite database (for codex resume).

continue — Transfer and launch the target agent

Transfers the session, then spawns the target CLI so you can keep working immediately.

fork — Copy part of a session to another agent

Original session stays untouched.

handoff — Generate a context summary

Produces a compressed context brief you can paste into any agent (including ones without adapters).

search — Full-text search across all sessions

stats — Aggregate statistics

Shows session counts per agent, date range, total messages, and models used.

doctor — Health check

Checks for broken SKILL.md files, missing CLAUDE.md, MCP server configs, and CLI availability.

adapters — List registered agents

Architecture

Universal Tool Taxonomy

Every tool call from any agent maps to a universal operation:

Adapter Pattern

Adding a new agent requires implementing the…