Tutti

Tutti — Multi-Agent Orchestration

Orchestrate a team of AI coding agents from a declarative tutti.toml config. Launch agents in isolated git worktrees, run verification workflows, track token usage, and manage context handoffs — all through a single CLI.

When to use this skill

Use when the user asks you to:

Prerequisites

1. tt binary installed and on PATH (install from https://github.com/nutthouse/tutti) 2. tmux installed 3. python3 available 4. A tutti.toml config file in the workspace root

Always run preflight checks before starting a workflow:

python3 tutti_openclaw.py doctor_check

Actions

All actions go through the wrapper script. Every action returns a consistent JSON envelope:

{
  "ok": true,
  "action": "action_name",
  "command": ["tt", "..."],
  "exit_code": 0,
  "data": {},
  "stdout": "",
  "stderr": ""
}

Lifecycle

| Action | Command | Purpose | |--------|---------|---------| | doctor_check | python3 tutti_openclaw.py doctor_check | Preflight: verify tools, config, and environment | | launch_team | python3 tutti_openclaw.py launch_team | Launch all agents defined in tutti.toml | | launch_agent | python3 tutti_openclaw.py launch_agent | Launch a single agent | | send_prompt | python3 tutti_openclaw.py send_prompt [--auto-up] [--wait] [--output] | Send a prompt to an agent with optional auto-start, wait-for-idle, and output capture | | team_status | python3 tutti_openclaw.py team_status | Read agent states from .tutti/state/ | | agent_output | python3 tutti_openclaw.py agent_output --lines 50 | Peek at an agent's terminal output | | stop_agent | python3 tutti_openclaw.py stop_agent | Stop a single agent | | stop_team | python3 tutti_openclaw.py stop_team | Stop all agents |

Workflows

| Action | Command | Purpose | |--------|---------|---------| | list_workflows | python3 tutti_openclaw.py list_workflows | Discover available workflows | | plan_workflow | python3 tutti_openclaw.py plan_workflow [--strict] | Dry-run a workflow | | run_workflow | python3 tutti_openclaw.py run_workflow [--agent ] [--strict] | Execute a workflow | | verify_team | python3 tutti_openclaw.py verify_team [--workflow ] [--strict] | Run verification workflow | | read_verify_status | python3 tutti_openclaw.py read_verify_status | Read last verification result |

Git Operations

| Action | Command | Purpose | |--------|---------|---------| | land_agent | python3 tutti_openclaw.py land_agent [--pr] [--force] | Land an agent's branch back to current branch, or open a PR |

Handoffs

| Action | Command | Purpose | |--------|---------|---------| | generate_handoff | python3 tutti_openclaw.py generate_handoff [--reason ] | Capture agent context to a packet | | apply_handoff | python3 tutti_openclaw.py apply_handoff [--packet ] | Inject a handoff packet into an agent | | list_handoffs | python3 tutti_openclaw.py list_handoffs [--agent ] [--limit 20] | List available handoff packets |

Permissions

| Action | Command | Purpose | |--------|---------|---------| | permissions_check | python3 tutti_openclaw.py permissions_check | Check if a command is allowed by policy |

Workflow step types

Workflows in tutti.toml support these step types:

| Type | Purpose | Key fields | |------|---------|------------| | prompt | Send text to an agent session | agent, text, inject_files, wait_for_idle, wait_timeout_secs | | command | Execute a shell command | run, cwd, timeout_secs, fail_mode | | ensure_running | Start an agent if not already running | agent, fail_mode | | workflow | Execute another workflow as a nested step | workflow, agent, strict, fail_mode | | land | Land an agent's branch | agent, pr, force, fail_mode | | review | Send an agent's diff to a reviewer | agent, reviewer, fail_mode |

Prompt steps support inject_files — an array of workspace-relative file paths that are copied into the agent's worktree before the prompt is sent. This enables stateful context passing between agents (e.g., injecting a snapshot JSON produced by another agent).

Nested workflow steps enable composition: observe → dispatch → fix → verify → land as a chain of workflow invocations.

Execution pattern

Follow this sequence for orchestrating a workspace:

1. Preflight — doctor_check. Stop and report if non-zero. 2. Launch — launch_team or launch_agent . 3. Monitor — team_status and agent_output to observe progress. 4. Dispatch — send_prompt "do something" --auto-up --wait --output to dispatch work and capture results. 5. Workflow — list_workflows to discover, then run_workflow . 6. Verify — verify_team --strict for gate-style quality checks. 7. Land — land_agent to cherry-pick work, or land_agent --pr to open a PR. 8. Handoff — generate_handoff when context is high, apply_handoff to resume. 9. Stop — stop_team or stop_agent when done.

Failure handling

python3 tutti_openclaw.py --tt-bin /path/to/tt doctor_check
or via environment variable
TUTTI_BIN=/path/to/tt python3 tutti_openclaw.py doctor_check

1. tt binary installed and on PATH (install from https://github.com/nutthouse/tutti) 2. tmux installed 3. python3 available 4. A tutti.toml config file in the workspace root

Always run preflight checks before starting a workflow:

python3 tutti_openclaw.py doctor_check