Quickstart

brew install dwmkerr/tools/signalbox
signalbox init

signalbox init walks you through setup: it starts the hub, wires up your coding agents, and checks the menu bar app. It is idempotent - re-run it any time for a status checklist.

What is signalbox?

signalbox is a tool that configures your coding agents to send a signal as they work - when a task is running, when a message comes back, when input is needed. The signals go to an app on your machine, so you can see the status of every session and jump between them through a macOS jumplist.

This means you can:

• See every session in one place - which are working, which need your input, which failed.
• Jump to any session with a single keystroke - hit ⌃⌥J, and jump to any session in any terminal, or straight to a CI run in the browser.
• Monitor many parallel tasks at once - long-running jobs and agent sessions, ordered the way you work.

Open a few agent sessions across your terminals and tmux tabs:

Then hit ⌃⌥J and jump to the one you want:

Features at a glance

• Clear signals - amber means a session needs your input, blue means output updated, red means failed. The same colours everywhere: jumplist, menu bar, and tmux.
• Rename sessions - press ⌃R in the jumplist to give any session your own name.
• Native tmux switcher - a status-line count and an in-tmux picker, no app needed.

Native tmux switcher

Live entirely in the terminal if you prefer. A status-line segment shows the waiting count, and prefix + j opens a picker over the sessions that need you - Enter jumps to the pane. Navigating to a pane clears its signal, because looking at it is seeing it.

Setup is two lines of tmux config - signalbox init prints them, or see docs/tmux.md.

Privacy & Security

signalbox sends signals and messages from coding agent sessions - these can include sensitive data. When running locally, no data leaves your machine. This is an early-stage, experimental project and should still be used with caution.

Building from source

Needs bun:

make install       # compiles the CLI and links it into ~/.local/bin
make app           # builds the menu bar app to components/app/build/Signalbox.app
signalbox init

License

MIT.