# session-porter

> Move AI coding sessions between Claude Code and Codex CLI without losing context.

**Status:** Released | **Language:** TypeScript | **License:** MIT
**Repo:** https://github.com/liwala/session-porter

## The Problem

Claude Code and Codex CLI both store sessions as JSONL on disk — but in incompatible shapes. Switching tools mid-task means losing the entire conversation, or pasting summaries back and forth by hand.

## What It Does

- List, summarize, and show sessions from any installed agent
- Transfer sessions between Claude Code and Codex CLI (and back)
- Four transfer modes: raw, full, compact, resume-only
- Fork part of a session (last-N turns, from-turn N)
- Export to JSON, Markdown, or each agent's native JSONL
- Generate compressed handoff briefs you can paste into any agent
- Registers Codex sessions in the SQLite database for codex resume
- Local-only, zero network, zero API keys

## Quick Start

```bash
npm install -g @liwala/session-porter

session-porter list --claude -n 10
session-porter summary <session-id>
session-porter transfer <session-id> --to codex --mode compact
codex resume <session-id>
```