> ## 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 and hidden from the top-level help in Entire CLI `0.7.8`. Run `entire import --help` to see the agents supported by your installed CLI version.
</Note>

## Supported agents

In Entire CLI `0.7.8`, import supports:

| Agent         | Command                         |
| ------------- | ------------------------------- |
| Claude Code   | `entire import claude-code`     |
| Codex         | `entire import codex`           |
| Copilot CLI   | `entire import copilot-cli`     |
| Cursor        | `entire import cursor`          |
| Factory Droid | `entire import factoryai-droid` |
| Gemini CLI    | `entire import gemini`          |
| 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>