Agents

The Agents dialog is a tree of every coding-agent session currently connected to Honeymux, grouped by locality and team, and color-coded by provider. Open it with A from the Main Menu, a bound agents key, or by clicking the Mux-o-Tron.

XXX TODO: Better screenshot

Reading the tree

Each row is one agent session. Rows are grouped under a single root (⊙); local sessions come first, remote sessions follow and are ordered by host. Sessions that share a teamName nest one level deeper under the team lead, labeled with the team name and total member count. Everything else is a standalone session directly under the root.

The status glyph at the start of the label shows state: a colored dot (●) for unanswered, a centered dot (·) for alive, and ↗ for alive sessions on a remote host. When a pane is producing output, the alive glyph is overdrawn with a sine-synced activity spinner.

To the right of the tree, fixed-width columns fill in as the dialog width permits — in order of priority: prompt, cwd, host, pid, session (first UUID segment). Narrow dialogs drop the lower-priority columns rather than truncating labels.

See Agent Integrations for which providers are supported and how consent works.

Navigating

Use Up/Down (or Tab/Shift+Tab) to move the focus arrow through the data rows; the root entry is skipped. Press Enter to switch focus to the selected session’s pane and close the dialog. Press Esc to close without switching. Clicking a row with the mouse activates it directly; clicking outside the dialog dismisses it.

While the dialog is open, the Mux-o-Tron’s prev/next agent actions navigate within the dialog instead of the sidebar, and each step both moves the focus and activates the row under it.

The agents zoom view

The zoomAgentsView action expands the agent tree to the full terminal width without opening the dialog — it is the “always visible” counterpart to the dialog. Unlike the dialog, the zoom view does not capture keyboard focus, so typing continues to reach the active pane.

Binding behavior depends on zoomAgentsViewStickyKey (default on): when sticky, tap the bound key to toggle the overlay; when off, hold the key to show it and release to hide. Toggle sticky mode from the Main Menu’s zoom controls (⊙), or set zoomAgentsViewStickyKey in config.json. The Mux-o-Tron’s prev/next agent actions navigate the zoomed tree the same way they navigate the dialog.

XXX TODO: Better screenshot

Relationship to the Mux-o-Tron

The two counters in the Mux-o-Tron correspond 1:1 with this dialog’s contents: the total counter equals the number of data rows in the tree, and the unanswered counter equals the number of rows whose status glyph is the unanswered dot. Clicking the Mux-o-Tron opens this dialog. Configuring agents as a bound action gives the dialog a dedicated hotkey.