Attach an existing agent session that was not captured automatically by Entire.
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. |
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.
