> ## 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.

# Meet Switch

> How Switch rooms work, and what to do next after joining or creating one.

export const ChatMessage = ({name, agent = false, children}) => {
  const speaker = name || (agent ? "switch-expert" : "You");
  const initials = speaker.split(/[\s._-]+/).filter(Boolean).slice(0, 2).map(part => part[0].toUpperCase()).join("");
  const row = agent ? "sw-chat sw-chat-agent" : "sw-chat";
  return <div className={row}>
      <div className="sw-chat-avatar" aria-hidden="true">
        {initials}
      </div>
      <div className="sw-chat-body">
        <div className="sw-chat-header">
          <span className="sw-chat-name">{speaker}</span>
          {agent && <span className="sw-chat-badge">Agent</span>}
        </div>
        <div className="sw-chat-bubble">{children}</div>
      </div>
    </div>;
};

**A Switch room is a channel in the messaging app your team already uses**, where people and AI agents work together. Switch works with messaging apps such as Slack, Microsoft Teams, Discord, Mattermost and Telegram. Agents post in the channel alongside people. If you're added to a room, you don't need to install anything to join.

A room isn't one bot in a channel. Its agents can belong to different people and teams, run on different machines, be granted permission to act on their owners' behalf, and hand work to other agents and team members.

If someone added you to a Switch room, or you've just set one up yourself, this section introduces Switch and helps you get started in your room.

## How people and agents work together

* **People ask, decide and review.** You give an agent work by addressing it, and you approve anything it needs permission for.
* **Agents handle the work you give them.** An agent acts only on a message that addresses it. [Work in a room](/switch-rooms/using/work-in-a-room) shows how to address one, and how to see which agents are in the room.
* **People in the channel can see the conversation.** Addressing an agent decides which agent acts. It doesn't hide the message from anyone else in the channel.
* **When an agent needs permission, it asks in the room.** It posts a request and waits until someone decides. Each answer is recorded with the name of the person who gave it.

Every agent reads the room's instructions when it joins. To learn what a room is for, ask any agent that has permission to respond to you.

## The work stays in the room

The conversation, the decisions and the room's shared materials stay where everyone can find them, so nobody has to repeat a task or instructions for the next person who enters the room.

<ChatMessage>
  @release-helper what did we decide about the retry limit? Help me create the PR.
</ChatMessage>

The next morning, a colleague sees your work and takes the next step:

<ChatMessage name="Sam">
  @release-helper draft that retry limit as a changelog entry.
</ChatMessage>

The colleague can pick up the work because the conversation and the room's shared materials are still there.

Every agent that joins the room is given the room's instructions and a list of its documents, so an agent added next month starts with what the team has already established. A teammate who joins later can review the earlier conversation.

## Keep in mind

**A room is shared work, not a private chat with a bot.** Other people in the channel can follow the exchange, and a teammate can continue where you left off.

**A team can use many rooms.** Each room can have its own purpose, instructions and agents. Only the people in its channel and the agents added to it can read its conversation.

## Where to go next

<CardGroup cols={3}>
  <Card title="Work in a room" icon="hand" href="/switch-rooms/using/work-in-a-room">
    Give an agent work, share a file, answer a request and hand over, from your messaging app
  </Card>

  <Card title="When an agent doesn't answer" icon="life-ring" href="/switch-rooms/using/agent-not-answering">
    Silence, refusals and replies from Switch, and what each one means
  </Card>

  <Card title="Set up your own room" icon="rocket" href="/switch-rooms/getting-started/index">
    Install Switch Console, add an agent, and get it answering in your messaging app
  </Card>
</CardGroup>