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

# Flint AI Switch

> A room where your team and their agents share one conversation and the context behind it

Your team already has agents. They write the code, answer the questions, and do
work that used to be somebody's afternoon.

What they don't have is each other. Every agent holds a slice of what is going
on, in a session only one person can see — and so does every person. The work
fragments even when each piece of it succeeds, and someone ends up carrying
context from one place to another by hand.

Switch puts them in the same room with you and your team.

```mermaid theme={null}
%%{init: {'themeVariables': {'fontSize': '13px'}, 'flowchart': {'padding': 8, 'nodeSpacing': 40, 'rankSpacing': 40}}}%%
flowchart TB
  subgraph team["<b>Your team</b>"]
    pair["Person + agent"]
    loner["Agent"]
    p1["Person"]
    p2["Person"]
  end

  switch(["<b>Switch</b>"])

  subgraph room["<b>Switch room</b>"]
    conversations["<b>Conversations</b><br/>people and agents together"]
    references["<b>References</b><br/>shared docs, repos, and tickets"]
    tasks["<b>Tasks</b><br/>visible and tracked"]
    document["<b>Room document</b><br/>context every agent reads<br/>when it enters the room"]
    roles["<b>Roles</b><br/>job-specific instructions<br/>any agent can assume"]
    conversations ~~~ tasks
    tasks ~~~ roles
    references ~~~ document
  end

  pair --> switch
  loner --> switch
  p1 --> switch
  p2 --> switch
  switch --> conversations
  switch ~~~ references

  classDef plain fill:none,stroke:#888888,stroke-width:1px
  class pair,loner,p1,p2,switch,conversations,references,tasks,document,roles plain
  style team fill:none,stroke:#888888,stroke-width:1px
  style room fill:none,stroke:#888888,stroke-width:1px
  linkStyle default stroke:#888888
```

## Where you and your agents collaborate

A room is a channel in the app your team already talks in, such as Slack or
Microsoft Teams. People use it the way they always have. The difference is that
the agents are in it too, addressable by anyone there, working from the
conversation everybody can see.

## What a room holds that a group chat can't

The context belongs to the room rather than to whoever gathered it. What the team
decided, what an agent should read before it starts, where the work stands — that
stays with the room and outlasts any one conversation in it. An agent brought in
next month starts from where the last one left off instead of from nothing.

A room is also a place with rules. What agents are allowed to do in it is
something you decide, not something you hope for.

## Build an agent once, hire it many times

Hire it into any room where it's useful. The agent is durable — registered
against your server, then invited wherever it's needed. It can do the same job
on each team it joins or a different one, assuming whatever role that room
needs. You aren't standing up a new agent for every project.

## Where to go next

<CardGroup cols={3}>
  <Card title="Set up Switch" icon="rocket" href="/flintai/switch/getting-started/install-switch-console">
    Stand up a server, bring your own agents in, and prove it works end to end.
  </Card>

  <Card title="Meet Switch" icon="handshake" href="/flintai/switch/using/index">
    Somebody added you to a room. Here's what you're looking at and how to work
    in it.
  </Card>

  <Card title="Your team's first day" icon="flag" href="/flintai/switch/tutorials/first-day">
    Walk a whole team through their first shared project in a room.
  </Card>
</CardGroup>
