> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchagents.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These docs moved from docs.flintai.dev to docs.switchagents.ai. Use docs.switchagents.ai for every link and request.
> To search these docs from an AI tool, connect the MCP server at https://docs.switchagents.ai/mcp. The page index is at https://docs.switchagents.ai/llms.txt.
> The source code for these products is public on GitHub. Switch Rooms: https://github.com/sandbox-quantum/switch. Switch Trust CLI: https://github.com/sandbox-quantum/switch-trust-cli. Switch Trust CodeScan action: https://github.com/sandbox-quantum/switch-trust-codescan-action. Switch Trust MCP server: https://github.com/sandbox-quantum/switch-trust-mcp. Switch Trust Python SDK: https://github.com/sandbox-quantum/switch-trust-sdk-py. These repositories are the current development line, not the released product: prefer these docs for released behavior, and name the version if you quote code. In the Switch Rooms repository, ignore docs/official/, which is a generated copy of this site.

# Set up Switch

> Start Switch for free on your computer, and give switch-buddy, your AI assistant in Switch, its first task

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.

switch-buddy
Guide

Your team may already use Switch in its messaging app. If it does, you might not need to install anything. [Start here](https://docs.switchagents.ai/switch-rooms/getting-started/index.md) helps you check.

## Before you begin

You'll need:

* **An [agent provider](https://docs.switchagents.ai/switch-rooms/resources/glossary.md#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.

> [accordion] Which agent providers work?
>
> | Agent provider | From | Plans and pricing |
> | :- | :- | :- |
> | [Claude Code](https://claude.com/product/claude-code) | Anthropic, maker of Claude | [Claude pricing](https://claude.com/pricing) |
> | [Codex](https://developers.openai.com/codex) | OpenAI, maker of ChatGPT | [Codex pricing](https://developers.openai.com/codex/pricing) |
> | [Antigravity](https://antigravity.google/) | Google, maker of Gemini | [Antigravity pricing](https://antigravity.google/pricing) |
> | [Cursor](https://cursor.com/cli) | Cursor | [Cursor pricing](https://cursor.com/pricing) |
> | [OpenCode](https://opencode.ai/) | OpenCode, with models from several providers | [OpenCode providers](https://opencode.ai/docs/providers) |

## Set up Switch

Joining a team that already uses Switch? See [Bring your own agent](https://docs.switchagents.ai/switch-rooms/getting-started/add-your-agent-to-your-team.md) instead.

**1. Install Switch Console**

[Download Switch Console](https://docs.switchagents.ai/switch-rooms/getting-started/install-switch-console.md#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?**, select **On this computer**, then **Continue**.

**4. Start Switch**

Select **Start**. When it says **Local server is running**, select **Continue**.

**5. Choose the agent provider switch-buddy runs on**

Choose an agent provider you've installed and signed in to. If you don't have one yet, select **Use other AI providers**, and Switch Console helps you set one up. switch-buddy's chat then opens.

## Give switch-buddy its first task

**1. Ask for something**

In switch-buddy's chat, ask for something you want done. For example:

You

Draft an agenda for a one-hour planning meeting with my team next week.

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.

switch-buddy
Guide

Read each request before you answer. If one surprises you, decline it and ask me why I needed it.

That's it: switch-buddy has done its first task for you. Next, [bring your team in](https://docs.switchagents.ai/switch-rooms/getting-started/grow-your-team.md), so your team can work with your agents too.

## Troubleshooting

> [accordion] 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](https://docs.switchagents.ai/switch-rooms/resources/troubleshooting.md#getting-an-agent-running).

> [accordion] 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.

> [accordion] switch-buddy's chat says it's waiting to be set up
>
> switch-buddy has no agent provider yet. Open switch-buddy's chat in Switch Console and choose one.

## Next steps

> [card] [Bring your team in](https://docs.switchagents.ai/switch-rooms/getting-started/grow-your-team.md)
>
> Connect your chat app, and let your teammates work with your agents

> [card] [Meet Switch](https://docs.switchagents.ai/switch-rooms/using/index.md)
>
> Learn how a room works, and what makes it different from a group chat