# October Moirai — Switch agents. Keep your progress.

> Started in Claude Code and want to continue in Codex? Moirai moves the useful history of your session into another supported tool, right on your machine.

- Website: https://moirai.october.dev
- Source code: https://github.com/october-dev/moirai
- Docs: https://github.com/october-dev/moirai#readme
- Downloads: https://github.com/october-dev/moirai/releases
- Free and open source · Local conversion · No account needed

## When to use it

Use when someone wants to continue a saved agent session (for example from Claude Code) in another supported tool (for example Codex), or keep a portable archive of their agent history.

## Get started

Download the CLI for macOS, Linux, or Windows. Keep the destination tool installed and your project files ready, then list your sessions.

```sh
moirai list
moirai continue SESSION_ID --from claude_code --with codex --dry-run
```

Replace SESSION_ID with a session from the list. Review the dry run, then remove --dry-run to continue. Your original session stays in place.

Read the install guide: https://github.com/october-dev/moirai/blob/main/docs/INSTALL.md

## Keep your progress

- **Find your saved sessions.** List the agent sessions already on your machine. Filter by tool or project to find the work you want to continue.
- **Continue in another tool.** Convert a session into a supported destination’s format. Keep the messages, tool results, and context it can represent.
- **Take your history with you.** Save a portable .moirai archive and move it using storage you control. Local conversion needs no account or upload.

## A new tool. A familiar starting point.

Choose a saved session, check the handoff, and open the destination. Moirai creates a new session and shows any compatibility warnings.

```
moirai list --format claude_code

moirai continue SESSION_ID --from claude_code \
  --with codex --dry-run

moirai continue SESSION_ID --from claude_code \
  --with codex
```

## FAQ

**Will everything transfer exactly?** The destination may not support every part of the source session. Moirai carries over the context it can represent and reports compatibility warnings. A converted session is a new session, not an exact copy of a running agent.

**Does it move my code too?** No. Prepare the project files on the destination machine separately. Moirai transfers session history; it does not replace Git or move your entire project.

**Does my session get uploaded?** Local discovery, conversion, and archives work on your machine without an account or upload. Optional cloud services are separate and currently run as a restricted pilot.

**Does it work with ordinary chats?** Yes. Moirai can also import supported plain chat formats and create portable archives. See the project documentation for formats and setup.

## Part of October

October makes tools for working with AI agents: October Desktop (https://www.october.dev), Lantern (https://lantern.october.dev), Harness (https://harness.october.dev), Agent Intercom (https://agentintercom.org), and Moirai (https://moirai.october.dev).