The jumplist shows every agent session in one place and jumps you to the one you pick: the right terminal window and tmux pane, or the browser for remote work like CI runs. It is a floating panel that takes keys while your app keeps focus, and dismisses on esc, the shortcut, or a click elsewhere. Drag any background area to reposition it, like Alfred or Raycast. It remembers its position across opens and recenters if that spot is offscreen, for example after a display is unplugged.
The hub status light sits at the left of the footer, opposite the cog, where you already look while using the jumplist. Everyday hub status belongs here, not hidden inside Settings. Its exact states are Hub healthy with a green dot, Hub warning with an amber dot, and Hub starting with a grey dot. It never names a mode because "Remote" reads as a place, not as health.
Click the light for a popover with Mode, Address, Hub version, and, only in Remote mode, Uplink. Address reads not answering in amber when the hub is down. Uplink reads connected, down, N events spooled in amber, or starting. The values are monospace and selectable. Open Settings closes the jumplist and opens the Hub tab; Open log closes it and opens the Logs tab. A click elsewhere, or esc, closes the popover. There are no menu bar items for the light, these facts, or its links.
A bold title means unread. The amber mark alone means the session is asking for you.
The line under each name is the latest line of the exchange. While a session works you see your prompt; once it finishes, asks, or fails you see its reply. The preview on the right highlights the same line with the colored bullet, so the list and the preview always agree.
Tags are discreet lowercase pills after the title: a filing aid, never a status. They come from
signalbox session tag or fire --tag; #tag matches them and
!tag excludes them in Additional filters. components/scripts/demo.sh tags
every seeded session demo, so !demo hides a demo board.
The icon on each row shows the originator, taken from the event's agent
field (see the data model). Each surface
maps the agent name to its glyph. Known agents today, with the fallback for everything else:
| Icon | Agent |
|---|---|
claude - Claude Code | |
opencode - OpenCode | |
codex - Codex | |
| π | pi - pi |
cursor - Cursor's own agent (the isometric-cube mark alone) | |
cursor/<agent> - an agent hosted in Cursor's terminal (e.g. cursor/claude): the Cursor mark with the sub-agent's glyph badged bottom-right in a clear halo | |
vscode/<agent> - an agent hosted in VS Code's terminal (e.g. vscode/claude): the VS Code ribbon mark with the sub-agent's glyph badged bottom-right in a clear halo | |
github - GitHub Actions | |
anything else (script, custom agents) - a plain ring, the fallback |
The top of the panel is a search bar and it is always focused: any printable key filters the list
live, matching the name, the prompt breadcrumb, the reply, and the agent. A query starting with
# switches to tag mode - #demo shows only sessions carrying that tag
(case-insensitive, exact match); clearing it restores all. Every open starts with an empty
search. Any additional filters apply underneath the search, to this
list and the menu bar dropdown alike.
Rows keep the order you work in (most recently engaged first, like the app switcher), with pinned sessions first; status does not reorder them. The panel opens with the topmost unread row selected, and selection stays topmost-unread within the filtered rows.
Hiding a session with ⌃X drops it from the list until it speaks again. To bring one
back before then, the jumplist mirrors the mobile app: a collapsed Hidden (N) divider sits at
the bottom of the list, below every visible row. It is always shown once the board has a session,
Hidden (0) included, so it is always clear whether a session is set aside - a missing row is
otherwise a mystery. Hidden (0) is inert (no chevron, nothing to expand). With a count, select
it and press ↩ (or click it) to expand:
the hidden rows appear beneath it, dimmed and marked with an eye-slash. ⌃X on a hidden
row unhides it - the same key that hid it, reversed (it fires the show event) -
and it rejoins the list above. Press ↩ on the divider again to collapse. A live search
reaches into the hidden rows too, revealing the section when a match is tucked inside it, so a
hidden session is never lost - only set aside.
Pin a session to keep it at the top: pinned sessions sort before the rest (engagement order within each group) and carry a pin mark on the row and in the menu bar dropdown. Order is a hub decision: the app applies the same rule locally - a pin toggle moves the row into or out of the pinned group immediately, and an engagement bump never lifts an unpinned row above a pinned one - so the list always matches what the hub's order would show. Pin or unpin the selected row with ⌃P; pins survive agent activity and hub restarts.
Right-click any row for the same actions as a menu: Pin/Unpin, Rename, Hide (or Unhide on a revealed hidden row), and Remove.
When an agent blocks on you, the row shows the actual ask, not a generic "needs your
permission": a pending tool approval reads as the command it wants to run
(Bash: git push origin main - the codex-mcp-server and
signalbox-hub rows below), and an agent question reads as the question with its
options inline (the dwmkerr-toolkit row). Both are ordinary attention events whose
reply carries the ask - the amber mark and preview pane render them with no special
casing. The wire vocabulary (reason: permission_request / question, and
the no-clobber rule that keeps the rich ask when a bare duplicate notification arrives) is
specified in events.md;
how each agent's adapter captures the ask (Claude Code's PermissionRequest and
matcher-scoped PreToolUse[AskUserQuestion] hooks, Codex's native
permission requests) is specified in
adapters.md.
The board never answers for you: asks are read-only signal, and the answer happens where the
agent runs - jump.
The right pane is the last exchange, on black like the terminal it quotes: your prompt, then the
agent's reply. The bullet is amber for asks and blue for finished work. While a session works you
see a live ✻ Working… line with the runtime. The line above the footer says exactly
where ↩ takes you, for example "Jump to iTerm (tmux dwmkerr:1) on localhost".
Typing is searching, so list commands use the control key:
| Keys | Action |
|---|---|
| ↩ | Jump to the selected session (marks it seen) |
| ⌃J ⌃K or arrows | Down / up |
| ⌃1 ⌃2 … | Jump directly to a session |
| ⇥ | Next unread |
| ⌃P | Pin / unpin the selected session (pinned sessions sort first) |
| ⌃R | Rename session (your own name for it; empty clears) |
| ⌃X | Hide until the session speaks again; on a row in the expanded Hidden section, unhide it |
| ⌃⌫ | Remove now |
| ⌘, | Open Settings (same as the footer cog) |
| Hub status light | Open the hub facts popover; Open Settings targets Hub and Open log targets Logs |
| ⌘+ ⌘− ⌘0 | Zoom the jumplist in / out / reset (0.8×-1.6×, persists) |
| esc | Clear the search, then close |
Zoom scales the whole panel, geometry and text together, and text stays crisp for dense screens or recordings. The footer keys strip stays unchanged; ⌘+/−/0 are universal conventions and the strip is already full.