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

```
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:

```
entire session attach SESSION_ID --agent AGENT --force
```

## Attach a review session

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

```
entire session attach SESSION_ID --agent codex --review
```

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

```
entire session attach SESSION_ID --agent codex --review --skills review
```

## Continue with

[**List Sessions** 
Find the session ID to attach.](https://docs.entire.io/guides/sessions/list-sessions)

[**attach Command Reference** 
See attach flags and examples.](https://docs.entire.io/cli-reference/attach)

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