Attach an existing agent session that was not captured automatically by Entire.
entire session attach SESSION_ID [flags]
- 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.
