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

> Import pre-existing local agent transcripts as read-only checkpoints.

Import pre-existing local agent transcripts for the current repository as read-only checkpoints.

```bash theme={null}
entire import AGENT [flags]
```

<Note>
  `entire import` is experimental. It appears under **Experimental commands** in developer and nightly builds, but is hidden from top-level help in stable releases. It remains runnable in all builds and appears in [`entire labs`](/cli-reference/labs). Run `entire import --help` to see supported agents.
</Note>

## Supported Agents

| Agent | Command |
| - | - |
| Claude Code | `entire import claude-code` |
| Codex | `entire import codex` |
| Copilot CLI | `entire import copilot-cli` |
| Cursor | `entire import cursor` |
| Factory | `entire import factoryai-droid` |
| Pi | `entire import pi` |

## Flags

| Flag | Description |
| - | - |
| `--dry-run` | Report what would be imported without writing checkpoints |
| `--path DIRECTORY` | Override the transcript directory to import from |
| `--session ID` | Import only this session ID. Repeatable. |

## Examples

Check what would be imported:

```bash theme={null}
entire import claude-code --dry-run
```

Import Claude Code transcript history:

```bash theme={null}
entire import claude-code
```

Import a specific Codex session:

```bash theme={null}
entire import codex --session SESSION_ID
```

Import from a custom transcript directory:

```bash theme={null}
entire import claude-code --path TRANSCRIPT_DIRECTORY
```

## Behavior

`entire import` scans the agent's local transcript store for the current repository and imports history from the past month.

Imported checkpoints are:

* read-only
* searchable
* explainable
* idempotent, so already-imported turns are skipped
* not rewindable
* not linked to a Git commit

## Continue With

<CardGroup cols={2}>
  <Card title="Import Past Sessions" icon="terminal" href="/guides/sessions/import-past-agent-history">
    Follow the guide for importing past local agent sessions.
  </Card>

  <Card title="Search" icon="sparkles" href="/cli-reference/search">
    Search imported checkpoints and other Entire history.
  </Card>
</CardGroup>
