Repository navigation
tmux Integration
ChrAlpha edited this page Nov 12, 2026
·
3 revisions
🇬🇧English | 🇨🇳中文
-
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 (
!), withmonitor-bellon, as by default.prefix + M-n/M-palready jump between flagged windows. -
prefix + Ajumps to the agent that has waited longest: blocked ones first, then idle ones. -
prefix + aopens a tree of the panes running agents, with their state. -
#{tmag_status}instatus-left/status-rightshows2 blocked · 1 working. -
#{E:@tmag-pane-status}inpane-border-formatlabels each pane (claude working,codex blocked permission).
| 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.