docs: document session adoption · Entire

docs: document session adoption

a8e0b96·

peyton-alt·2w ago·2 files·+11 added/-1 removed

Sessions

0ed46044b4c8View transcript

[?
Session Adoption and Worktree Management FixesCodex·1 step](/content/gh/entireio/cli/session/019ef09e-1621-7183-8205-646a383a2faf#timeline-0ed46044b4c8/index.html)

Changes

2

28 unmodified lines

29
30
31
32
32
33
34
35
36
37
38
39
40
41
42
43

28 unmodified lines

discoverable through `entire labs` and may remain hidden from root help while
their canonical paths are still runnable.

- `session` (alias: `sessions`): `list`, `info`, `tokens`, `stop`, `attach`, `resume`, `current`.
- `session` (alias: `sessions`): `list`, `info`, `tokens`, `stop`, `attach`, `adopt`, `resume`, `current`.
  `resume` with a branch arg switches to it and resumes its session; with no arg
  it opens an interactive picker of stopped sessions (across all worktrees),
  resolving each to its branch and pointing at the owning worktree when the
  branch is checked out elsewhere. Resume keeps an existing local session log
  as-is by default (`--force` overwrites it from the checkpoint).
  `adopt` moves an active session from another repo or worktree into the current
  worktree and resets target-local checkpoint bookkeeping so future commits link
  to the adopted session from the new location.
- `checkpoint` (aliases: `cp`, `checkpoints`): `list`, `explain`, `tokens`, `search`, plus
  the deprecated `rewind` (functional, prints a cobra deprecation message, will
  be removed in a future release)

MCLAUDE.md+4/-1

158 unmodified lines

159
160
161
162
163
164
165
166
167
168
169
170
171

158 unmodified lines

it falls back to deriving the branch from the session's last checkpoint ID found
in branch-only commit trailers.

`entire session adopt` moves an active session from a source repo or worktree
into the current worktree. Adoption preserves the live transcript path, validates
that the source state still belongs to the requested source worktree, rewrites
the session's branch/worktree/base metadata to the target, clears target-local
checkpoint windows and checkpoint IDs, and snapshots the target's current file
changes so the next commit can link to the adopted session.

### Temporary Checkpoints

Branch: `entire/<commit[:7]>-<worktreeHash[:6]>`