Quickstart

Get up and running with Recast in a few steps.

1. Discover your chats

See what conversations are available for migration:

recast list claudecode
recast list opencode
recast list antigravity

2. Migrate a conversation

Pick a chat ID from the list and migrate it:

recast migrate \\
  --from claudecode \\
  --to antigravity \\
  --source ~/.claude/projects/.../session-id.jsonl \\
  --target /tmp/migrated.jsonl

Behind the scenes, Recast:

1. Parses the source agent's storage format (JSONL, SQLite).
2. Converts messages into a common Intermediate Representation.
3. Serializes the IR into the target agent's format.

3. Port your project configs

Migrate workspace rules and ignore files:

cd /path/to/your/project
recast port-config --from claudecode --to antigravity --dir .

This copies CLAUDE.md → GEMINI.md and .claudeignore → .geminiignore without overwriting existing files.