peer-sessions - Run and coordinate local Claude Code peer sessions
Spawns, addresses, and manages fleets of local Claude Code peer sessions in cmux or herdr for cross-session messaging.
Tags
Updated: 2026-09-19Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Spawn peer session fleets
- Resolve peer socket addresses
- Send messages to peer sessions
- Recover peer replies from transcripts
- Tear down peer session fleets
- Drive peers directly via herdr
Inputs
- Session names and directory paths
- Placement options
- Target session names, PIDs, or sockets
- Task briefs and prompts
Outputs
- Spawned terminal panes, workspaces, or windows
- Session UDS socket addresses
- Cross-session message user turns
- Teardown commands and terminal outputs
Requirements
- Python 3 runtime
- Claude Code CLI
- cmux or herdr backend
- Process and socket read access