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

# Attach Sessions

> Link an existing agent session to a commit and checkpoint.

Attach a session when useful agent context exists, but Entire did not link it automatically.

## When to attach a session

Use `entire session attach` when:

* hooks were not installed when the session started
* hooks did not fire
* a research session should be linked to the latest commit
* a completed agent review should be preserved as review context

## Attach a session

Attach reads an existing agent transcript, creates or updates a checkpoint, and links that context to the last commit.

```bash theme={null}
entire session attach SESSION_ID --agent AGENT
```

If the last commit already has an `Entire-Checkpoint` trailer, the session is added to that checkpoint. Otherwise, Entire creates a checkpoint and can amend the last commit with the trailer.

## Attach without prompts

Use `--force` when you want Entire to skip confirmation and amend the last commit:

```bash theme={null}
entire session attach SESSION_ID --agent AGENT --force
```

## Attach a review session

Use `--review` when the session was an agent review of existing work:

```bash theme={null}
entire session attach SESSION_ID --agent codex --review
```

If the review used specific Skills, declare them with `--skills`:

```bash theme={null}
entire session attach SESSION_ID --agent codex --review --skills review
```

## Continue with

<CardGroup cols={2}>
  <Card title="List Sessions" icon="list" href="/guides/sessions/list-sessions">
    Find the session ID to attach.
  </Card>

  <Card title="attach Command Reference" icon="link" href="/cli-reference/attach">
    See attach flags and examples.
  </Card>

  <Card title="Import Past Sessions" icon="terminal" href="/guides/sessions/import-past-agent-history">
    Bring past local agent sessions into Entire as read-only checkpoints.
  </Card>
</CardGroup>
