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

# 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

> **[List Sessions](/guides/sessions/list-sessions)**
>
> Find the session ID to attach.

> **[session attach Command Reference](/cli-reference/session#session-attach)**
>
> See attach flags and examples.

> **[Import Past Sessions](/guides/sessions/import-past-agent-history)**
>
> Bring past local agent sessions into Entire as read-only checkpoints.