Import Past Sessions - Entire

When to import past sessions

Use entire import when:

• you enabled Entire after useful agent work already happened
• you want past local agent sessions to become searchable in Entire
• you want to import sessions from an agent’s local transcript store

Preview an import

Use --dry-run to see what Entire would import before writing checkpoints:

entire import claude-code --dry-run

The preview shows how many sessions and turns Entire found, what would be imported, and what was already imported.

Import past sessions

Import reads agent transcripts for the current repository, creates read-only checkpoints, and makes that history available in Entire. Run import from inside the repository whose agent history you want to bring into Entire:

entire import claude-code

Replace claude-code with the agent you want to import from. Run entire import --help or see the import command reference for supported agents and flags.

Import specific sessions

Use --session when you only want to import a specific session:

entire import claude-code --session SESSION_ID

You can repeat --session to import more than one session.

Import from a custom transcript path

Use --path when the agent transcripts are stored somewhere other than the default location:

entire import claude-code --path TRANSCRIPT_DIRECTORY

What imported sessions become

Imported sessions are stored as read-only checkpoints on Entire’s checkpoint metadata branch. Imported checkpoints are:

• searchable
• explainable
• idempotent, so re-running import skips turns that already exist
• not linked to a Git commit
• not rewindable

Continue with

[**Semantic Search**

Search imported history by phrase, meaning, or agent context.](https://docs.entire.io/guides/search/semantic-search/overview)

[**import Command Reference**

See import syntax, flags, and supported agents.](https://docs.entire.io/cli-reference/import)

[**Attach Sessions**

Link a missed session to the latest commit.](https://docs.entire.io/guides/sessions/attach-sessions)

[**Inspect Sessions**

Inspect session metadata and transcript output.](https://docs.entire.io/guides/sessions/inspect-sessions-in-cli)