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

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

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

> **[Import Past Sessions](/guides/sessions/import-past-agent-history.md)**
>
> Follow the guide for importing past local agent sessions.

> **[Search](/cli-reference/search.md)**
>
> Search imported checkpoints and other Entire history.