Tmux Agent Tools

Fast paths (read this first)

Non-negotiable rules:

Engine-only — never type raw tmux at a worker. Drive every worker through agent-tmux <cli> subcommands (send-wait, status, result, capture, stop); read-only inventory is tmux-agent-sessions list, not raw tmux ls. Raw tmux bypasses naming, redaction, result contracts, and cleanup. Before concluding the engine lacks a command, check the capability table below; plain shell is a last resort for genuine gaps — say why.
A send is not done until submission is verified. Bare send can leave text unsent in the input box. Default to send-wait: it appends a fresh nonce and waits for it, confirming the prompt landed.
Every blocking wait takes a timeout — never hand-roll sleep/polling loops. Multiple workers: one bounded watch --any|--all|--count <n> --timeout <s> --json …. Mixed-engine fleets: trust reason:result_updated or resolve with tmux-agent-sessions.
Reusing a worker for a follow-up task? result init first, then send-wait, then result wait-required — never reuse without result init, or the wait returns the stale prior result. Details: references/multi-agent.md#persistent-teammates-worker-reuse.

Fast answers: