Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-host it, with any agent harness and any model.
Installing Switch Console
Switch Console is distributed as a desktop app through GitHub Releases on this
repository (sandbox-quantum/switch). The repo is public, so the downloads
need no account, token or sign-up. No need to build from source.
Builds are currently macOS arm64 (Apple Silicon) and x64 (Intel), Linux x64 and arm64 and Windows x64. On Windows, an agent runs on the PC itself as a managed agent, on a server with agent management on; otherwise it needs an SSH host — see Install (Windows x64).
Download
Option A — browser (simplest)
- Open the repo's Releases page.
- Find the latest release titled
Switch Console <version>(tagswitch-console-v<version>). - Under Assets, download the file for your platform —
.dmgon macOS, one of.AppImage/.deb/.rpmon Linux, or.exeon Windows (a.msiis also published if you deploy that way).
Option B — command line
Release assets are public, so a plain curl works — no token, no gh:
# Download an installer from a specific release (macOS — Apple Silicon):
curl -fLO https://github.com/sandbox-quantum/switch/releases/download/switch-console-v<version>/switch-console-arm64.dmg
# macOS on Intel:
curl -fLO https://github.com/sandbox-quantum/switch/releases/download/switch-console-v<version>/switch-console-x64.dmg
# Linux — pick the format your distro uses:
curl -fLO https://github.com/sandbox-quantum/switch/releases/download/switch-console-v<version>/switch-console-x86_64.AppImage
# Windows:
curl -fLO https://github.com/sandbox-quantum/switch/releases/download/switch-console-v<version>/switch-console-x64.exe
With the gh CLI, if you prefer it:
gh release list --repo sandbox-quantum/switch | grep switch-console-v
gh release download switch-console-v<version> \
--repo sandbox-quantum/switch \
--pattern '*.dmg'
Install (macOS)
Two .dmg files are published — take the one matching your Mac:
| Mac | Asset |
|---|---|
| Apple Silicon (M1 and later) | switch-console-arm64.dmg |
| Intel | switch-console-x64.dmg |
Apple menu → About This Mac names the chip if you are unsure; uname -m
prints arm64 or x86_64.
- Open the downloaded
.dmg. - Drag Switch Console into your Applications folder.
Tagged macOS releases are signed and notarized with SandboxAQ's Developer ID, so they open without a Gatekeeper bypass. Both architectures receive in-app updates, each one offered its own build.
Install (Linux)
Linux builds are unsigned. First check which arch you are on — the assets carry it in the filename, and each packager reports it differently:
dpkg --print-architecture # amd64 | arm64
An asset for the wrong arch does not fail cleanly. apt reports every
dependency as "not installable" (including core ones like libuuid1), which
reads like a broken package list rather than an arch mismatch.
Pick the format your distro uses:
AppImage — no install step; make it executable and run it:
chmod +x switch-console-x86_64.AppImage # arm64: switch-console-arm64.AppImage ./switch-console-x86_64.AppImageOn Ubuntu 22.04+ the AppImage needs FUSE 2 (
sudo apt install libfuse2), and on 24.04+ AppArmor's restriction on unprivileged user namespaces can break Electron's sandbox. The.debhas neither problem — it installschrome-sandboxcorrectly — so prefer it on Ubuntu.Debian / Ubuntu (
.deb):sudo apt install ./switch-console-amd64.deb # arm64: switch-console-arm64.debUse
apt install ./file.debrather thandpkg -i, so the Electron runtime dependencies get resolved.Fedora / RHEL (
.rpm):sudo dnf install ./switch-console-x86_64.rpm # arm64: switch-console-aarch64.rpm
The app does not yet set a
desktopName, so desktop environments may not associate its windows with the installed.desktopentry (the icon can appear as a duplicate or generic entry in the taskbar).
Install (Windows x64)
- Run the downloaded
switch-console-x64.exe. - Choose an install location if you want a non-default one, and finish the installer.
Code signing
Windows builds from 0.27.2 onwards are Authenticode signed, via Azure Trusted
Signing, as SandboxAQ. The installer no longer trips the blue "Windows
protected your PC" SmartScreen prompt, and AppLocker / WDAC policies that block
unsigned binaries no longer refuse it outright (CHOO-1468).
Two caveats:
- 0.27.1 and earlier are unsigned. They still show the SmartScreen prompt — click More info, then Run anyway — and managed Windows may refuse them. Installing a current version is the fix.
- SmartScreen also weighs a certificate's reputation, so a brand-new one can
still warn on early downloads. That fades as installs accumulate; it is not a
sign the signature is missing. To check one yourself: right-click the
.exe→ Properties → Digital Signatures.
The .msi supports the usual msiexec flow if you would rather not run the
installer interactively.
Where agents run on Windows
On a server with agent management on (a local server Console runs has it), a new agent on This computer runs on the PC as a managed agent: Console's built-in agents controller runs it, once Run managed agents on this computer is on. Antigravity has no Windows build, so it can't run there.
On a server without agent management, Console runs the agent itself, and those sessions need a POSIX execution host, so Windows Console asks you to pick an SSH host instead: a Linux or macOS machine you can reach over SSH, set up from Settings → Remote hosts. Connecting to a Switch server and working in rooms are unaffected either way.
Running a server through Docker
Switch Console looks for Docker Desktop and Rancher Desktop on Windows, so it can
find docker.exe for a local server. Running a local server from Windows Console
has not been exercised end to end yet; please report what happens if you try it.
Windows support is new and less exercised than the other platforms; please report anything that misbehaves.
Updating
Switch Console checks this repo's Releases for new versions in-app and offers the update when one is available — no sign-in of any kind. Settings checks automatically; you can also recheck manually.
You can always grab a newer build manually from the Releases page and re-install (drag over the old app).
Building from source
Only needed for a platform with no published artifact. Requires the Node version
in console/.nvmrc and the pinned pnpm, plus build-essential, python3 (for
the native modules) and rpm if you want the .rpm target. Budget ~10 GB free
disk: Electron's download plus the unpacked tree are several GB.
git clone https://github.com/sandbox-quantum/switch.git
cd switch/console
pnpm install
pnpm run build # workspace packages, then the app
pnpm --filter @switch-console/desktop run rebuild # native modules for THIS machine
cd apps/switch-console-desktop
pnpm run package:linux # or package:linux:arm64 / package:mac / package:mac:x64 / package:win
The first two steps are not optional. Packaging from the app directory alone
fails at the renderer with Failed to resolve entry for package "@switch-console/shared" — the workspace packages publish a dist/ that has
not been built yet. And because npmRebuild is off, skipping the rebuild ships
whatever native binaries happen to be in node_modules.
Artifacts land in console/apps/switch-console-desktop/release/.
Notes
- Release asset filenames are prefixed
switch-console-(e.g.switch-console-arm64.dmg). The macOS app id still readscom.switchdash.*, which is deliberate — it is what carries update continuity for copies installed before the rename, and no user sees it. - Upgrading a Linux install from a pre-rename build:
aptanddnfseeswitch-consoleas a new package rather than an upgrade ofswitchdash, so remove the old one yourself (sudo apt remove switchdash) or the two sit side by side. - Stable Switch Console releases use the
switch-console-v*tag prefix and are published as the repo's Latest release, because that is the release the stable auto-updater reads. Every other release in this repo, Switch Console canaries included, is published with "Latest" off so that it never becomes the stable update feed.