spawn-backends

Configure teammate agent backends across in-process, tmux, and iterm2.

14|1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/zircote/claude-team-orchestration --skill spawn-backends
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spawn-backends
Source: https://github.com/zircote/claude-team-orchestration/tree/main/skills/spawn-backends
Command: npx skills add https://github.com/zircote/claude-team-orchestration --skill spawn-backends

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code users need to run teammate agents across multiple backends (in-process, tmux, and iterm2) with predictable behavior and easy switching.

Core Features & Use Cases

  • Automatic backend detection based on environment and availability, plus manual overrides.
  • Guidance for setting up display modes, split panes, and persistent sessions across backends.
  • Troubleshooting tips and configuration options to ensure teammates run as expected in different environments.

Quick Start

Set teammateMode to auto, in-process, tmux, or iterm2 as needed, then start Claude Code to spawn and manage teammate backends.

Frequently Asked Questions about spawn-backends

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Claude Code teammate agents to run in tmux or iterm2?

Switch teammate backends by setting teammateMode to in-process, tmux, or iterm2 through settings.json, CLI flags, or environment variables, leveraging auto-detection logic to apply the correct configuration automatically.

What is the difference between in-process, tmux, and iterm2 backends for Claude Code teammates?

In-process backends run teammates within the main Claude Code session, while tmux and iterm2 backends spawn agents in separate split panes or persistent terminal sessions for isolated, visible parallel execution.

Why are my Claude Code teammate display modes not working correctly?

Troubleshoot teammate backend issues by verifying teammateMode configuration in settings.json, checking environment variable overrides, and ensuring tmux or iterm2 are installed and available for auto-detection.

Can I use auto-detection to switch between Claude Code backends automatically?

Yes, setting teammateMode to auto enables Claude Code to detect the environment and automatically select the best available backend among in-process, tmux, and iterm2 for spawning teammate agents.

Do I need tmux installed to use split pane display modes for Claude Code teammates?

Yes, tmux must be installed and available in your environment to use tmux backend split pane display modes, or you can explicitly configure iterm2 as an alternative backend via teammateMode settings.