ASB

Agent Switch Board is a native switch board with GTK 4 and Libadwaita: GNOME on Linux, and Windows with MSYS2. It lists your Codex and Claude Desktop Code chats and opens a chat in its own app; it also lists OpenCode 2 sessions and shows Claude Code CLI and Codex CLI sessions (view only). An optional machine group shows sessions from your other computers, an optional Android app shows them on your phone, and the optional ASB Bridge lets sessions message each other. The Messages window shows the newest messages that your agents send each other on all machines, with their text, and the Usage window shows the tokens and the API price of the agents on all machines. ASB reads the app stores read-only and makes no model calls.

asb-demo-app-switching.mp4

What it does

• List Codex and Claude Desktop Code chats and open them in their own app.
• List OpenCode 2 sessions and show Claude Code CLI and Codex CLI sessions (view only).
• Show Pending attention, unread marks, pins, and a drawer for sessions.
• Show sessions from your other computers in an optional machine group.
• Show sessions and notifications on Android, with an Android 16 Live update chip and Pending counts first.
• Let sessions message each other through ASB Bridge, also by session reference; Claude Code uses resolved send names.
• Show the messages that your agents send each other on all machines in the Messages window (first opens on 24 hours): a round table of the machines and sessions, the totals, and the thread of a pair or a session with the text (Claude Code messages and ASB Bridge messages).
• Show the tokens and the API price of the Codex, Claude Code, OpenCode, Antigravity, Grok, and Pi agents on all machines in the Usage window (first opens on All time). Usage downloads the LiteLLM price list (prices only) while you use it, and keeps it for a day.
• Keep the usage history of your machines, also after the apps delete old transcripts. ASB saves a backup file of the usage of every machine each day and keeps the last 5. Move the usage to another machine with Export… and Import… in Preferences > Usage, or with asb usage export and asb usage import.
• Show in the GNOME top bar how many sessions need you, how many work, and how many your machines have, with an optional GNOME Shell extension.
• Play Done, Needs input, and Failed sounds on the PC.
• Read the app stores read-only and make no model calls.

Support by app

App	Cards	Status	Questions	Approvals	Open	Messages	Rename	Archive	Windows
Codex app	✓	✓	✓	✗ Codex saves no approval wait	✓	✓	✗ ASB work	✗ ASB work	✓
Codex CLI	✓	✓	✓	✗ Codex saves no approval wait	✗ Codex saves no process ID	✓ daemon tasks only	✗ ASB work	✗ ASB work	✓
Claude Desktop Code	✓	✓	✓	✓	✓	✓	✗ Anthropic: no entry point	✗ Anthropic: no entry point	✓
Claude Code CLI	✓	✓	✓	✓	✗ ASB work: terminal tab	✓	✗ ASB work	✗ Anthropic: no archive	✓
OpenCode 2	✓	✓	✗ OpenCode: memory only	✗ OpenCode: memory only	✗ OpenCode: no session link	✓ no reference sends to it	✗ ASB work	✗ ASB work	✓
Claude Code on the web	✓ Claude app cache	✓ fresh cache only	✓ one signal	✓ one signal	✓	✗ Anthropic: cloud only	✗ Not planned: login	✗ Not planned: login	✗ ASB work: cache format

✓ works. ✗ not yet: the note says what it waits on. "ASB work" means only ASB code is missing. Rename and Archive mean from the board. All apps also have Read and Unread, pins, the drawer, Mute, Discard, sounds, and the phone. Cards of other machines do not open and have no Discard.

Install on Linux

Needs Node.js >=20 (sqlite3 below 22.13), Python 3 with PyGObject, GTK >=4.12, Libadwaita >=1.4, xdg-utils, and openssl. Install Codex and Claude Desktop first, with working codex: and claude: URL handlers.

Install with npm

npm install -g --install-links github:Jamir-boop/ASB
asb setup

Keep --install-links: npm 11 needs it to keep the install working. asb setup asks what to set up: the board and ASB Bridge, the board only (--only board), or the bridge only (--only bridge). See the full install guide for system checks, distribution packages, release packages, and engine-only use.

Install on Windows

Windows needs Node.js 22.13 or later and uses the same npm commands. ASB runs the engine and the GTK window on Windows. The window needs MSYS2 Python, PyGObject, GTK >=4.12, and Libadwaita >=1.4. See Windows setup for the packages and commands.

Android companion (optional)

The optional Android app shows your sessions and notifications on your phone; phone access is off by default. The live notification shows Pending counts first and can be an Android 16 Live update, so HyperOS can show it in its island; in-app messages show in a small dark pill over the toolbar. The Messages and Usage screens show the counts and statuses of the agent messages (no text) and the token usage of all machines. See the Android guide for pairing, building, and installing the app.

ASB Bridge (optional)

The ASB 1.13.0 packages have ASB Bridge 0.8.0, with OpenCode 2 support and sends by session reference (asb:1/...) from Codex and OpenCode. Claude Code sessions run asb agent resolve-session <reference> to get the SendMessage name (Send name:); asb bridge status says when an installed skill is out of date and which asb bridge install target updates it. See the bridge guide and setup and recovery.

User guide · Privacy · Source setup · Contributing · Install guide

ASB Bridge is based on claude-uds-bridge by Leon Kohli (MIT). See bridge/LICENSE.

ASB plays Done, Needs input, and Failed sounds on the PC. The sounds are audio from opencode, commit fe87944b6ae85422db64c751b6d6ee488b0d7f1c (MIT, Copyright (c) 2025 opencode). The PC copies in assets/sounds/ are louder than the originals: a gain of 8 to 19 dB and a limiter at about −1 dB peak, because the originals are too quiet on PC speakers. The Android app uses the original files. See assets/sounds/opencode-LICENSE.txt.

Based on Agent Mission Control 0.6.0 by forxidian. MIT license.