team

Coordinate parallel AI workers across a shared task list using tmux orchestration.

Updated Jul 3, 2025
One-click install
npx skills add https://github.com/andrew-t-james/dotfiles --skill team-andrew-t-james
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team
Source: https://github.com/andrew-t-james/dotfiles/tree/main/dot_codex/skills/team
Command: npx skills add https://github.com/andrew-t-james/dotfiles --skill team-andrew-t-james

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating multiple AI workers across a shared task list using tmux-based orchestration to ensure reliable startup, state propagation, and lifecycle control.

Core Features & Use Cases

  • Durable multi-agent orchestration via omx team in tmux, including leader/worker state, inbox/outbox, and mailbox-based messaging.
  • Per-worker lifecycle management: startup, readiness checks, task dispatch, health monitoring, and clean shutdown.
  • Team-state synchronization and evidence collection: .omx/state and mailbox artifacts; supports audit trails and reproducible runs.
  • Use Case: Orchestrate parallel analysis tasks across Codex/Claude workers to reduce overall time-to-insight.

Quick Start

Initialize a new OMX team run with omx team and monitor readiness and progress across worker panes.

Frequently Asked Questions about team

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

FAQPage Schema
How do I coordinate parallel AI agents in tmux?

You can coordinate parallel AI agents in tmux using an orchestration framework that manages worker panes, synchronizes state, and dispatches tasks. This Skill handles reliable startup, readiness checks, and lifecycle control for durable multi-agent workflows.

What is tmux-based multi-agent orchestration and when do I need it?

Tmux-based multi-agent orchestration coordinates multiple AI workers across shared task lists using tmux panes. You need it for durable multi-agent workflows requiring synchronized state propagation, evidence collection, and clean lifecycle management.

Can I use this to orchestrate both Codex and Claude workers in parallel?

Yes, you can orchestrate both Codex and Claude workers in parallel. This orchestration approach supports coordinated kickoff, state management, and lifecycle control across Codex and Claude teams using mailbox-based messaging.

How do I start a parallel agent workflow and monitor readiness across worker panes?

To start a parallel agent workflow, initialize a team run using the omx team command. This launches worker panes in tmux, and you can monitor readiness and progress across those panes to ensure all agents are synchronized and ready for task dispatch.

How does state synchronization work for parallel execution workflows?

State synchronization works by managing team state in a .omx/state directory and using mailbox-based messaging via inbox and outbox files. This ensures consistent state propagation, evidence collection, and audit trails across all parallel workers.

What are the limitations of using tmux for multi-agent workflow orchestration?

A limitation of using tmux for multi-agent orchestration is the strict operator contract: you must launch via omx team, manage state in .omx/state, and write to inbox.md. It also requires careful handling of readiness checks, error states, and clean shutdown procedures.