> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Import Past Sessions

> Bring past local agent sessions into Entire as read-only checkpoints.

Import past sessions when useful agent context exists locally, but Entire did not capture it while the work happened.

<Frame>
  <div style={{ position: 'relative', paddingTop: '60.9375%', width: '100%', overflow: 'hidden', borderRadius: '0.5rem' }}>
    <iframe src="https://customer-0x5hsk8lh27fm00g.cloudflarestream.com/15376992270a4d75618e299a3fb8b1d8/iframe?muted=true&loop=true&autoplay=true&poster=https%3A%2F%2Fcustomer-0x5hsk8lh27fm00g.cloudflarestream.com%2F15376992270a4d75618e299a3fb8b1d8%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600" title="Import existing Claude Code sessions demo" loading="lazy" style={{ border: 'none', position: 'absolute', top: 0, left: 0, height: '100%', width: '100%' }} allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture" allowFullScreen />
  </div>
</Frame>

## 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`](/guides/sessions/attach-sessions) |
| Continue working from an earlier session     | [`entire session resume`](/guides/sessions/resume-sessions) |

## Preview an import

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

```bash theme={null}
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:

```bash theme={null}
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](/cli-reference/import) for supported agents and flags.

## Import specific sessions

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

```bash theme={null}
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:

```bash theme={null}
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

<CardGroup cols={2}>
  <Card title="Semantic Search" icon="sparkles" href="/guides/search/semantic-search/overview">
    Search imported history by phrase, meaning, or agent context.
  </Card>

  <Card title="import Command Reference" icon="terminal" href="/cli-reference/import">
    See import syntax, flags, and supported agents.
  </Card>

  <Card title="Attach Sessions" icon="link" href="/guides/sessions/attach-sessions">
    Link a missed session to the latest commit.
  </Card>

  <Card title="Inspect Sessions" icon="terminal" href="/guides/sessions/inspect-sessions-in-cli">
    Inspect session metadata and transcript output.
  </Card>
</CardGroup>