Tmux Agent Command Orchestrator

Claude-powered multi-agent orchestration in tmux

$ brew install daedastream/taco/taco
$ taco -p "Build a todo app with React and Express"

Or install from source:

git clone https://github.com/Daedastream/taco.git && cd taco && ./install.sh

How It Works

TACO creates a Mother agent that analyzes your project and spawns specialized worker agents. Each agent works in its own tmux window, executing tasks in parallel.

1

Mother Analyzes

Mother agent reads your prompt and creates a JSON specification with specialized agents

→
2

Agents Spawn

Each agent gets its own tmux window with a specific role and dependencies

→
3

Parallel Work

Agents work simultaneously, communicating progress through tmux

Live Agent Orchestration

Watch agents work in real-time across tmux windows

0:Mother
3:frontend_ui
4:api_routes
5:database_schema
6:stripe_integration
7:admin_dashboard
8:authentication
9:integration_tests
Your Prompt

"Build an e-commerce platform with Next.js, Stripe payments, admin dashboard, and PostgreSQL"

[0] Mother orchestrating
Spawned 7 specialized agents
Coordinating dependencies...
[3] frontend_ui working
Next.js setup complete
Building product pages...
[4] api_routes working
Creating REST endpoints
/api/products ready
[5] database_schema complete
PostgreSQL schema created
Types exported ✓
[6] stripe_integration working
Stripe SDK configured
Setting up webhooks...
[7] admin_dashboard working
Dashboard layout created
Building order tracking...
[8] authentication complete
NextAuth configured
Sessions working ✓
[9] integration_tests waiting
Test suite ready
Waiting for APIs...
[taco-ecommerce] 7 agents active
15:34 10-Oct-25

Agent Communication via Tmux

Agents coordinate using tmux send-keys commands

Mother assigns task to agent
tmux send-keys -t taco:3 "[MOTHER → frontend_ui] Build product listing. API at :3001" Enter
Agent notifies completion
tmux send-keys -t taco:0 "[database_schema → MOTHER] COMPLETE: Schema ready at /shared/db-types.ts" Enter
Agent-to-agent coordination
tmux send-keys -t taco:4 "[api_routes → frontend_ui] Products API live at /api/products" Enter
Navigate between agents
tmux select-window -t taco:3 # Switch to frontend_ui agent
Monitor all agents
tmux list-windows -t taco # View all active agent windows

Message Flow Example

MOTHER → frontend_ui Task: Build product listing with cart. Use API at port 3001
database_schema → api_routes Schema ready. Types exported to /shared/db-types.ts
authentication → MOTHER COMPLETE: Auth system ready. Sessions working.
api_routes → frontend_ui Products API live at /api/products. Swagger docs at /api/docs
frontend_ui → MOTHER COMPLETE: Product pages ready. Cart working. Tests passing.

Usage

Interactive Mode

# Answer questions about your project taco

Quick Mode

# Just provide description, auto-detect rest taco -q

Direct Prompt

# Skip all prompts taco -p "Your project description"

From File

# Load detailed spec from file taco -f project.txt

Requirements

✓ bash
✓ tmux
✓ jq
✓ claude CLI