> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.com/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.

[Import existing Claude Code sessions demo](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)

## 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 in your repository's [checkpoint storage](/guides/checkpoints/checkpoint-storage), alongside the checkpoints Entire captures live.

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

> **[Search Past Work](/guides/search/overview)**
>
> Search imported history by phrase, meaning, or agent context.

> **[import Command Reference](/cli-reference/import)**
>
> See import syntax, flags, and supported agents.

> **[Attach Sessions](/guides/sessions/attach-sessions)**
>
> Link a missed session to the latest commit.

> **[Inspect Sessions](/guides/sessions/inspect-sessions-in-cli)**
>
> Inspect session metadata and transcript output.