## 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

| If you want to | Use |
| --- | --- |
| Bring past local agent sessions into Entire | `entire import AGENT` |
| Link one missed session to the latest commit | [`entire session attach`](https://docs.entire.io/guides/sessions/attach-sessions) |
| Continue working from an earlier session | [`entire session resume`](https://docs.entire.io/guides/sessions/resume-sessions) |

## 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](https://docs.entire.io/cli-reference/import) 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)