Your desktop. Your workflow.

All your agents, one key away.

Status remains visible from anywhere on your machine. When an agent needs approval, switch into its terminal at a keystroke.

Terminal

82%10:42

YOUR DESKTOP

Pull, don’t push

API reference

Chotchkie’s – Maps

notes.example / engineering / pull-dont-push

Fieldnotes

ENGINEERING / 3 MIN READ

Pull,
don’t push.

Status should wait for you, not interrupt you.

Notifications decide when you stop. A status bar lets you decide: glance when you choose, go back when you’re ready.

You pick the interruptions.

Terminal — tps-reports

peter@initech · ~/projects/tps-reportsbash

Terminal — herdr

peter@initech:~/projects$

A second terminal, on another workspace.

peter@initech · herdrbash

Switchboard no agents

01 / 06

Start agents the way you already do: Pi in one terminal, Claude Code and Codex inside herdr. Each one joins your bar.

Keys

Bar

WindowsTilingDesktop

Start agents in any terminal, or several inside herdr. Each appears in your bar: green while working, orange when done, red when it needs approval. One key focuses the highest-priority agent’s terminal and pane; two more step to the next or previous agent. Tiling or floating, your bar can be moved, styled, or hidden.

Stay in your flow

From a signal to the right session.

01 / keep working

Let your agents run.

Read, research, or work in another project. Switchboard discovers your Claude Code, Codex, and Pi sessions without pre-naming or registration.

02 / notice

A signal, not a ping.

A session’s color changes in the bar you already use. Nothing pops up; you look when it suits you. Pick your own colors, labels, icons, and layout.

03 / jump

One shortcut. Exact pane.

Bind a key to the session that needs attention, or click its bar entry. Switchboard focuses the right window and terminal pane, including when a child agent is waiting.

Fits your environment

Keep the setup you like.

Your terminal, window manager, and bar stay part of the workflow. Switchboard adds the connection between an agent asking for attention and the place you answer it.

Place sessions in your existing bar or a separate strip. Choose named chips, minimal dots, or your own design. Toggle the display for focus; your navigation shortcuts keep working.

Bar integrations & custom displays

What Switchboard supports
Layer	Supported	What you get
Agents	Claude Code Codex Pi	Found automatically. No registration or wrapper.
Integration	herdr	Status straight from herdr; a jump selects the exact pane.
Window managers	Hyprland sway i3 X11 / EWMH	Detected at runtime; raises the right window.
Terminals	WezTerm tmux foot Alacritty	Exact pane in WezTerm and tmux; the right window in foot and Alacritty.
Bars	Waybar Polybar eww i3blocks	Native Waybar and Polybar. Any script can read the session state.
Runs on	Linux	Seeing sessions needs nothing else, even over SSH.

Navigate

Supported desktop + terminal

Click a session or use your chosen shortcut to focus its window and pane. Switchboard detects supported integrations at runtime.

Display it your way

Every Linux box

Session data is available to any bar, script, or custom UI. Without a navigation integration, you can still see your sessions, even over SSH.

Get started

Make the connection.

Install Switchboard and start the daemon. Add sessions to your bar and bind one key to the highest-priority agent and two more to step through the rest.

Navigation requires a supported window manager and terminal. The terminal UI works on any Linux box.

Installation & documentation

terminalLinux + Go

# Install Switchboard
go install github.com/tjmisko/switchboard/cmd/...@latest

# Start the daemon
switchboard &

# Bind your keys
switchboard-ctl attention    # $mod + A: highest priority
switchboard-ctl cycle next   # $mod + →
switchboard-ctl cycle prev   # $mod + ←

Optional add-on / dashboard

Want to look back at the day?

Add the companion dashboard for project timelines, attention summaries, and cost estimates. Enable local activity history when you want it; recording is off by default.

Explore the optional dashboard

Your bar and navigation work without the dashboard.