Guide
Import sessions from Claude Code and Codex
Conversations you started with claude or codex in Terminal don’t have to stay there. Coincide can import them as threads that keep the agent’s own session, so the next message continues where the CLI left off.
Updated
Importing a session
- Choose File › Import CLI Session…. Coincide scans your local histories:
~/.claude/projectsfor Claude Code and~/.codex/sessionsand~/.codex/archived_sessionsfor Codex. It followsCLAUDE_CONFIG_DIRandCODEX_HOMEwhen Coincide itself was started with them, for example from Terminal; otherwise use Choose File… for histories kept elsewhere. - Search by title or folder and select a session to preview the conversation.
- Click Import. If you already imported that session, Coincide offers Open Existing Thread instead of making a duplicate.
To import a file the list doesn’t show, use Choose File… and pick a Claude Code session or Codex rollout .jsonl file.
What you get
- A thread that resumes the same session. The imported thread keeps the provider’s session ID, so your next message resumes the CLI’s own session natively. Switching to another agent works as in any thread: the next agent gets a recap.
- Nothing runs on import. Importing never starts an agent, and imported threads begin in Ask for approval mode, so the first turn can’t change files without you. Switch the thread to Full access if you want.
- A readable transcript. For Claude Code it follows the latest main branch of the conversation; for Codex it applies the rollback events, so turns you undid in the CLI stay undone.
The original file
Coincide never changes the CLI’s file. It keeps an exact private copy in its own data folder; File › Reveal Imported Source shows that copy in Finder. Anything the transcript can’t show stays in that copy: unsupported records, attachments, excluded branches of the conversation and text beyond the limits below. Deleting the imported thread also deletes its copy, and Undo restores both.
Limits
| Limit | Value |
|---|---|
| File size | 32 MB per file |
| Record size | 4 MB per record |
| Records | 100,000 per file |
| Text shown per transcript field | 100,000 characters |
| Preview | 200,000 characters |
| Sessions listed | 2,000, newest first |
A session over the file limits shows “This session exceeds the import limits (32 MB per file, 4 MB per record, or 100,000 records).” When some histories can’t be listed, the window says so and suggests Choose File….
Good to know
- Only Claude Code and Codex sessions can be imported. The other agents’ histories aren’t read.
- Claude Code’s subagent histories aren’t scanned automatically.
- Each session needs one valid session ID and an absolute working directory; Coincide refuses files without them.
- If the CLI writes to the file after you previewed it, Coincide asks you to select it again: “The session changed after the preview. Select it again to refresh before importing.”