tmux-team

Send tasks between AI agents through tmux panes and a local identity inbox.

11|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/wkh237/tmux-team --skill tmux-team-wkh237
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-team
Source: https://github.com/wkh237/tmux-team/tree/main/skills/tmux-team
Command: npx skills add https://github.com/wkh237/tmux-team --skill tmux-team-wkh237

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple AI coding agents on one machine normally means digging through terminal history and guessing whether a reply is complete. This Skill lets agents send work to named tmux panes, receive durable stored replies, and recover outstanding requests after timeouts, detachments, or pane loss. ## Core Features & Use Cases - Durable agent messaging: Send requests with tmt talk and collect complete replies via tmt reply and tmt result, correlated by request ID and receipt rather than terminal markers. - Identity and room management: Create global identities, bind them to tmux panes, group them into rooms, and queue inbox requests for offline agents. - Attention recovery: Use tmt x commands to list, inspect, and acknowledge outstanding requests after interruptions or restarts. - Use Case: A coordinator agent asks a reviewer agent in another pane to audit a patch, detaches immediately, and later retrieves the full review with tmt result <request-id>. ## Quick Start Ask the agent to send a review request to the tmux pane named reviewer and wait for its complete reply.

Frequently Asked Questions about tmux-team

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

FAQPage Schema
How do I send a task to another AI agent in a tmux pane?

Name the target pane with `tmt name reviewer`, then run `tmt talk reviewer "your message"` from any terminal on the same machine. The command waits for the recipient's durable reply submitted through `tmt reply`, or use `--detach` to get a request ID immediately.

How do I retrieve a reply after a talk request times out?

A timeout only ends the observer, never the recipient's work. Use `tmt result <request-id> --json` with the preserved request ID to collect the reply later, or `tmt x` to list unacknowledged requests for your identity.

Does tmux-team work without tmux installed?

Partially. Local identity storage, rooms, role profiles, notes, and the explicit `talk --inbox` queue work without tmux. Live pane binding, direct pane messaging, and pane inspection require tmux on the same machine.

What does DELIVERY_UNCERTAIN mean when sending a message?

It means input or Enter may already have reached the pane, so automatic resending risks duplicate work. Inspect the target with `tmt check <target>` to establish whether work started before deciding to retry.

Can an offline agent still receive requests?

Yes. An existing identity can receive requests through `tmt talk <name> "message" --inbox`, which queues the request in local SQLite without pane delivery. The recipient processes it later with `tmt x listen` and `x show --incoming`.