Skip to content

tmux Integration

ChrAlpha edited this page Nov 12, 2026 · 3 revisions
🇬🇧English | 🇨🇳中文

tmux Integration

  • Alerts. When an agent starts waiting for you or finishes a turn in a pane you are not looking at, its window gets tmux's bell flag (!), with monitor-bell on, as by default. prefix + M-n / M-p already jump between flagged windows.
  • prefix + A jumps to the agent that has waited longest: blocked ones first, then idle ones.
  • prefix + a opens a tree of the panes running agents, with their state.
  • #{tmag_status} in status-left / status-right shows 2 blocked · 1 working.
  • #{E:@tmag-pane-status} in pane-border-format labels each pane (claude working, codex blocked permission).

Options

Option Default
@tmag-key-picker a prefix key for the agent tree
@tmag-key-jump A prefix key to jump to the agent waiting longest
@tmag-key-setup M-a prefix key to connect the agents and check the installation
@tmag-key-serve M-r prefix key to open the local HTTP API in a window, or tell where it runs
@tmag-serve unset the arguments prefix + M-r gives tmag serve (see Local HTTP access)
@tmag-alert blocked,finished which changes alert you: ring a pane's bell, and run @tmag-notify
@tmag-notify unset a command that tells you of an alert away from the terminal (see Notifications)
@tmag-answer on who may decide an agent's permission prompts and questions with tmag answer, beside the agent's own dialog: on for people, agents for agents too, off for nobody
@tmag-peers on whether prefix + M-a gives the agents the tmag-peers skill, for working with each other; off removes it
@tmag-release-url GitHub releases where to download the binary, for mirrors

Set a key option to off to leave it unbound, @tmag-alert to off for no bells, @tmag-answer to off to answer prompts only in the agent, and @tmag-peers to off, then press prefix + M-a, to keep tmag out of the agents' context. Set options before TPM's run line.

Clone this wiki locally