skills.rest
arcthur
arcthurCOMMUNITY
Explore all skills by this author →
GitHub

parallel-agents

Orchestrate parallel AI coding agents with git worktrees and tmux isolation.

2|Updated Jan 9, 2023
Search Tags:#automation#ai#orchestration#worktree#tmux#parallel
One-click install
npx skills add https://github.com/arcthur/dotfiles --skill parallel-agents-arcthur
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: parallel-agents
Source: https://github.com/arcthur/dotfiles/tree/main/claude/.claude/skills/parallel-agents
Command: npx skills add https://github.com/arcthur/dotfiles --skill parallel-agents-arcthur

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Git worktrees and tmux orchestration enable parallel AI agent workflows with true isolation and centralized monitoring.

Core Features & Use Cases

  • Orchestrate multiple AI coding agents in parallel using git worktrees and tmux for isolation.
  • Manage status, rescue stuck agents, and merge completed work back into the main branch.
  • Support multi-agent workflows (Claude Code, Codex, OpenCode) with standardized window layouts and batch operations.

Quick Start

Start a parallel agents workflow by creating a worktree per agent and launching each agent in its own tmux pane.

Frequently Asked Questions about parallel-agents

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

FAQPage Schema
How do I run multiple AI coding agents in parallel using git worktrees?▼

Parallel AI agent orchestration uses git worktrees to isolate agents and tmux to manage each agent in a separate pane, allowing simultaneous execution. This setup enables centralized monitoring and effortless merging of completed work back to the main branch.

Can I use tmux to manage parallel Claude Code or Codex agents?▼

Yes, tmux manages parallel Claude Code, Codex, and OpenCode agents. The workflow uses standardized tmux window layouts to monitor agent status and perform batch operations across all isolated worktrees.

What is the best way to isolate parallel AI agents working on the same repository?▼

Git worktrees provide true isolation for parallel AI agents by creating separate working directories from a single repository. This prevents file conflicts and allows centralized status monitoring through tmux.

How do you rescue a stuck AI agent in a parallel worktree workflow?▼

Rescuing a stuck AI agent involves tmux status detection patterns to identify stalled processes within isolated worktrees. Once detected, you can intervene in the specific tmux pane without disrupting other running agents.

How to merge parallel AI agent work from separate git worktrees back to the main branch?▼

Merging parallel AI agent work uses safe removal and merge semantics built into the workflow. After monitoring confirms an agent's task is complete, its worktree changes merge back into the main branch automatically.

Do I need git worktrees and tmux to run parallel AI coding agents?▼

Git worktrees and tmux are required to enforce true isolation and centralized monitoring for parallel AI coding agents. Without them, agents risk conflicting over the same files and lack a standardized status detection interface.

Related Skills

Explore More Software Engineering Skills→
samueriosamuerio

agent-workspace

Create isolated branch-scoped workspaces using git worktree and tmux.

Community
Advanced
cryborg1211cryborg1211

vc:merge-worktree

Merge a git worktree branch into the main checkout and prune it.

Community
Intermediate
gitgoodordietryinggitgoodordietrying
1

coding-agent

Orchestrate coding agents via background processes in isolated workdirs.

Community
Advanced
maystudiosmaystudios
10

maxsim-batch

Coordinate parallel agent execution with git worktree isolation and PASS/FAIL results.

Community
Advanced