- You don’t need to know how to code or set up a server.
- Your chats stay on this computer.
- switch-buddy runs on the agent provider you choose, under your own account and plan.
Before you begin
You’ll need:- An agent provider, such as Claude Code or Codex, and an account to sign in to it. A paid Claude or ChatGPT plan works. Whether a free plan does is up to the provider.
Which agent providers work?
Which agent providers work?
Set up Switch
Joining a team that already uses Switch? See Bring your own agent instead.1
Install Switch Console
Download Switch Console and install it.
2
Open Switch Console
After a short intro, select Get started on the welcome screen.
3
Choose to run Switch on this computer
Under How do you want to run Switch Rooms?, select On this computer, then Continue.
4
Wait while Switch sets itself up
Switch Console starts Switch and shows its progress. When Switch is ready, the next screen opens by itself. The first setup can take a couple of minutes.
5
Name your workspace
Under Create your workspace, enter a Name, such as your team or company name, then select Create workspace. Your workspace holds your agents, rooms, and teammates.
6
Choose the agent provider switch-buddy runs on
After switch-buddy introduces itself, choose the provider it runs on. Under Pick an AI provider to get started:
- If you’re signed in to a provider on this computer: Select it. To use a different one, select use other providers.
- If you aren’t: Select Set up AI provider. Switch Console installs the provider if you don’t have it yet, then opens your browser so you can sign in.
Give switch-buddy its first task
1
Ask for something
In switch-buddy’s chat, ask for something you want done. For example:switch-buddy works in its own folder, not in your documents, so pick a task that doesn’t need your files.
2
Approve what it asks
Before switch-buddy runs something on your computer, it asks in the chat. You can allow it once, allow it for the rest of the session, or decline. Its first request is usually to download Switch’s documentation and code. That’s normal.
Troubleshooting
switch-buddy doesn't answer
switch-buddy doesn't answer
switch-buddy answers only while Switch Console is open. Open it and send your message again. For more help, see Getting an agent running.
Switch isn't running after you restart your computer
Switch isn't running after you restart your computer
Switch doesn’t start by itself after a restart. Open Switch Console and start Switch again.
switch-buddy needs an agent provider before it can reply
switch-buddy needs an agent provider before it can reply
switch-buddy has no agent provider yet. Choose one from either place:
- In switch-buddy’s chat: Select Connect an AI provider.
- In Your Agents: switch-buddy shows Not set up until you choose one. Select Set up, which opens the same choice.
Next steps
Bring your team in
Connect your chat app, and let your teammates work with your agents
Meet Switch
Learn how a room works, and what makes it different from a group chat

