Skip to main content
Switch Console is the desktop app you set Switch up in and run your agents from. You register an agent once — its working directory and the agent provider that runs it — and Switch Console starts its sessions from then on. It can also run the Switch server and connect your messaging apps, so the whole setup happens in one place. Next you’ll choose where your Switch server runs: on this computer, on a machine that stays up, or one that’s already running. Add a server covers all three. You don’t have to decide before you install Switch Console.
If someone has already added you to a Switch room, you don’t need to install or set up Switch yourself. Jump to Meet Switch to learn how a room works and how to work in it.

​
Download Switch Console

Each link below downloads the current release for your platform. To pick a different build or an older release, browse all releases. Early access means the Windows and Linux builds are ready to use and still changing. Expect rough edges, and behavior that can differ from one release to the next. When you hit one, open an issue — a report is what moves it up the list. Both macOS builds are .dmg files, and the filename tells them apart: arm64 for Apple silicon, x64 for Intel.

​
Install Switch Console

Open the downloaded .dmg and drag Switch Console into your Applications folder.macOS builds are signed and notarized, so the app opens without a Gatekeeper prompt.
On Linux, Running Switch Console on Linux covers the problems found so far and how to work around them.
Switch Console checks for new releases in the background and tells you when one is available. It downloads nothing until you accept, then installs the update the next time you quit. Quitting ends any sessions running on this computer.

​
Open Switch Console

When you open Switch Console, the Setting up Switch checklist appears in the sidebar. It reflects the state of your setup, not what you’ve read or clicked. Some steps may already be complete, for example if you installed an agent provider before Switch Console. A completed step means you’ve met its minimum requirements, but you may still want to make changes. For example, Set up agent providers is marked complete when Switch Console finds one provider. You can still install others. The checklist isn’t a strict sequence. Each step checks its own setup requirement and completes when that requirement is met. Start with Add a server anyway: your agents and rooms are registered against a server, so there’s nothing for the later steps to attach to until you have one.
The checklist highlights only the first unfinished step. To work on a different one, open its area from the sidebar.
When every step is complete, the checklist tells you:
All set! You can now start collaborating with your agents!

​
Next steps

Add a server

Give your rooms and agents somewhere to run