Open-source CLI · Go · MIT

Let your next coding agent catch itself up.

catchup is a small CLI your AI coding agents can run to read prior Claude Code, Codex, OpenCode, and Pi Agent sessions and print clean, handoff-ready Markdown. Agents continue work without you re-explaining what happened.

View on GitHub →

      Fig. 1 — Claude Code hits its limit; Codex runs catchup and keeps going
      no re-briefing
    

Claude Code hits its 5-hour limit in the left terminal pane, then Codex runs catchup claude in the right pane and continues the task.

What it does

I

Built for agent handoff

Your next agent runs catchup <agent> for codex, claude, opencode, or pi-agent to recover the relevant conversation.

II

Just the conversation

User and assistant messages only. Tool calls, reasoning traces, and token noise are stripped — what's left is the thread you actually need.

III

Readable by humans

Browsing manually? Start with catchup codex --list, then open the exact session you want.

IV

Fork back in

Run catchup fork to hand off to the agent's own native fork command — real session state, not a rendered transcript.

Supported agents

Claude Code

claude

Codex

codex

OpenCode

opencode

Pi Agent

pi-agent

Each agent keeps its own history format; catchup normalizes the output.

Hand the next agent a clean slate.

One go install and you're set. MIT-licensed, no config.

★ Star on GitHub Read the reference →