docs: add tmux pattern for agent handoffs #501
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add documentation for spawning worktrees with Claude running in detached tmux sessions, allowing one Claude session to hand off work to another in the background. Added to: - Tips & Patterns (near end, with other advanced patterns) - Claude Code Skill (as "Advanced" section with explicit requirements) The skill guidance requires: explicit user request, running in tmux, and authorization via CLAUDE.md or explicit instruction. Related to #476 Co-Authored-By: Claude <[email protected]>
Co-Authored-By: Claude <[email protected]>
Co-Authored-By: Claude <[email protected]>
Add `zellij run` as an alternative to tmux for spawning worktrees with Claude in the background. Rename section from "Agent handoffs in tmux" to "Agent handoffs" to be multiplexer-agnostic. The skill guidance now checks both $TMUX and $ZELLIJ env vars. Co-Authored-By: Claude <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Add documentation for spawning worktrees with Claude running in detached tmux sessions — one Claude session can hand off work to another that runs in the background.
Tips & Patterns (user-facing docs):
Claude Code Skill (guidance for Claude):
Related to #476 — documents the pattern as a tip rather than adding CLI flags.
@lucasoeth — this captures the workflow you proposed. Let me know if the documentation covers the use case well or if anything's missing.