[leonlee]

An auto author can now delegate separate PRs to subagents in their own git worktrees, and each subagent runs its own review loop through the session's reviewer. Up to N reviews run at once.

pair start --as claude --serve-worktrees --reviewers 2

How it works

• Opt-in: without --serve-worktrees, behavior is unchanged from 0.8.1.
• Routing: the author's environment carries PAIR_AUTO_OWNER, which subagents inherit, so a subagent's pair send reaches the session's socket, the only one a Claude author's sandbox allows.
• Enrollment happens on a worktree's first request, after validation:
  • the canonical top of a worktree of the same repository, listed by git worktree list;
  • no manual Codex session registered there;
  • its auto socket claimed (which keeps pair start and pair reset out);
  • the requested message is the pending one.
• Queue: one FIFO across all worktrees, the session's own included, with at most one entry per worktree. Retries and disconnects attach to the existing entry. --reviewers N (1–8, default 1) runs up to N at once.
• Identity: a worktree's path, inode and resolved git directory are re-checked at request, launch, every heartbeat while running, completion and retry. A removed or replaced worktree fails alone, and its reviewer is stopped.
• Per worktree: failures, settings snapshots and reviewer sessions. pair reviewer --thread current works from a served worktree, and pair status there names the serving session. The root's resume record never changes from a subagent.
• No writes into served worktrees: the reviewer's rules come in its prompt, and instruction refresh and pair init advice are skipped there.
• Compatibility: no message-format change. A request without a root, from an older CLI, means the session's own worktree.

Review

• Design: brainstorms 1887a1, 33039d and 86f267 (a session pool, not a global daemon).
• Spec: docs/specs/serve-worktrees.md, approved in thread 399fea after 3 medium fixes.
• Implementation: approved in 2dd5eb after 1 medium fix (identity must compare the current --absolute-git-dir).
• Status follow-up: approved in a539d4.

Tests

npm test: 129 pass, 10 of them new:

• opt-in off;
• a scoped subagent loop with no writes (a stale tracked AGENTS.md stays byte-identical);
• FIFO with N=1 and N=2;
• retries, simultaneous first contact, and an older client;
• per-worktree failure and its correction;
• a worktree removed while queued or running;
• a .git replaced while running;
• stop, and socket cleanup when the owner is SIGKILLed;
• enrollment refusals.

Live check (real Claude author, Codex reviewer)

• Claude Code subagents with worktree isolation (under .claude/worktrees/agent-…) were enrolled and reviewed in their own worktrees.
• With --reviewers 2, status showed running 2: two worktrees, two threads, two reviewer pids.
• pair status in a subagent worktree named the serving session. It also advised pair init, which would write files there; fixed in d76d4e1.
• Not checked live: the subagent worktrees were removed before their git status was captured. No-writes is covered by the scoped test.
• Observed: Claude Code based the subagent worktrees on main (d4d856e), not the session's branch.

No release until the set is merged (planned as 0.9.0).

🤖 Generated with Claude Code

https://claude.ai/code/session_012Y3kg5hjT2zSZM9qUEEinM