skills.rest
stevengonsalvez
stevengonsalvezCOMMUNITY
Explore all skills by this author →
GitHub

swarm-orchestration

Coordinate distributed Claude Code agents in isolated tmux sessions with file-based messaging.

Updated Apr 10, 2026
Search Tags:#workflow#beads#multi-agent#orchestration#tmux#inbox#swarm
One-click install
npx skills add https://github.com/stevengonsalvez/nanoclaw-standalone --skill swarm-orchestration-stevengonsalvez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swarm-orchestration
Source: https://github.com/stevengonsalvez/nanoclaw-standalone/tree/main/container/skills/swarm-orchestration
Command: npx skills add https://github.com/stevengonsalvez/nanoclaw-standalone --skill swarm-orchestration-stevengonsalvez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables Claude Code agents to operate as a persistent, coordinated swarm inside isolated tmux sessions with reliable inter-agent messaging via file-based inboxes.

Core Features & Use Cases

  • Persistent teamwork: agents stay alive across disconnects in dedicated tmux sessions.
  • File-based coordination: inter-agent messages are exchanged via inbox files and leader signals.
  • Beads integration: task coordination and progress tracking through Beads for scalable workflows.

Quick Start

Create a new swarm with /swarm-create, then attach to the leader session to begin coordinating agents.

Frequently Asked Questions about swarm-orchestration

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

FAQPage Schema
How do I coordinate multiple Claude Code agents in a persistent workflow?▼

Multi-agent orchestration with Claude Code agents is managed inside isolated tmux sessions, keeping agents alive across disconnects. A predictable runtime layout using team.json, inbox, and shared directories coordinates the distributed team.

How does file-based inter-agent messaging work across isolated sessions?▼

Inter-agent messaging works by exchanging messages via file-based inboxes and leader signals within a shared directory. This ensures reliable communication and task coordination between distributed agents running in separate tmux sessions.

Can I use tmux for multi-agent planning and task coordination?▼

Yes, tmux hosts distributed agents in dedicated persistent sessions for multi-agent planning. Task coordination and progress tracking are handled through Beads integration for scalable workflows.

Do I need any specific dependencies to set up a persistent agent swarm?▼

No external dependencies are required to set up a persistent agent swarm. The system operates using tmux for session isolation, file-based inboxes for messaging, and a runtime layout with team.json and shared directories.

What is the best way to start a multi-agent swarm for long-running collaboration?▼

The best way to start is by creating a new swarm with the /swarm-create command, then attaching to the leader session to begin coordinating agents. This establishes the isolated tmux environment and shared directories.

Does swarm orchestration support different isolation modes for agent workspaces?▼

Swarm orchestration supports both shared and worktree isolation modes for agent workspaces. This allows you to choose between a shared directory structure or isolated worktrees depending on your team collaboration requirements.

Related Skills

Explore More Software Engineering Skills→
5unnykum4r5unnykum4r
10

tmux

Manage tmux sessions, execute commands, and capture pane output.

Community
Intermediate
iliaaliliaal

orchestrating-swarms

Orchestrate multi-agent teams with leader-teammate models and JSON messaging.

Community
Advanced
hvent90hvent90
1

beads-agent-village

Orchestrate multi-agent workflows with Beads shared memory and MCP Agent Mail.

Community
Advanced
latestaiagentslatestaiagents
5

a2a-protocols

Implement Agent-to-Agent communication protocols for cross-framework interoperability.

Official
Advanced