## Attach an Existing Agent Session

Attach an existing agent session that was not captured automatically by Entire.

```
entire session attach SESSION_ID [flags]
```

This command reads the session transcript, creates or updates a checkpoint, and links it to your last commit. Use it when:

- Hooks were not installed when the session started
- Hooks failed to fire
- You want to keep a research-only session that did not produce file changes

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

| Flag | Description |
| --- | --- |
| `-a, --agent NAME` | Agent that created the session. Defaults to `claude-code`. Run `entire agent list` to see registered agents, including external agents. |
| `-f, --force` | Skip confirmation and amend the last commit with the checkpoint trailer |
| `--review` | Tag the attached session as an agent review. |
| `--skills SKILL` | Declare which review skills were run. Repeatable; only used with `--review`. |

```
# Attach a Codex session and amend HEAD automatically
entire session attach 019d6c43-1537-7343-9691-1f8cee04fe59 -a codex -f

# Attach a Claude Code session using the default agent
entire session attach 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcbfe

# Attach a Codex session as a review
entire session attach 019d6c43-1537-7343-9691-1f8cee04fe59 -a codex --review
```

`entire session attach` requires the repository to already have at least one commit. If Entire cannot find the transcript for the agent you specify, it will try to auto-detect the correct agent from known transcript locations.