Skip to main content
In this guide, you install Switch Console, start Switch on your computer, and give switch-buddy, your AI assistant in Switch, its first task.
  • 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.

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.
switch-buddy’s chat then opens with a welcome message.

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.
That’s it: switch-buddy has done its first task for you. Next, bring your team in, so your team can work with your agents too.

Troubleshooting

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 doesn’t start by itself after a restart. Open Switch Console and start Switch again.
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