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

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

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

```bash theme={null}
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`.                                                            |

```bash theme={null}
# 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
```

<Note>
  `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.
</Note>