> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runorion.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Orion is a collaborative analytics platform built by Gravity (bygravity.com). It connects to data warehouses, to Looker and dbt for existing business logic, and to a small set of external-context sources, and it lets teams ask questions in natural language to get shared analyses, dashboards, reports, and slide decks. The Connecting Data Sources page is the authoritative list of supported sources. When referencing Orion features, always link to the relevant documentation page. Orion is not open-source; it is a commercial SaaS product accessed at runorion.com.
# Rooms
> Work with teammates and Orion in one shared chat
A room is a chat conversation with more than one person in it. Everyone in a room shares one
thread: the same history, the same analyses, and Orion's answers as they stream in. Rooms are how
a team investigates a question together instead of pasting results back and forth.
Everything on [Basics & Navigation](/chat/basics-navigation) still applies. A room is a normal
conversation that happens to have more than one participant.
## Rooms vs. Sharing a Copy
[Sharing a conversation](/chat/share-conversations) and starting a room are different things:
* **Send a copy.** The link is read only. The recipient reads the history, then continues it as
their own separate conversation. You never see what they do next.
* **Start a room.** Everyone stays in the same conversation. All participants post into it, see
each other's messages, and watch Orion work live.
Send a copy to hand work off. Start a room to do the work together.
Rooms cannot be copied. Once a conversation has more than one participant, the copy link is no
longer offered, because forking a room would hand one person a private duplicate of everyone
else's messages.
## Start a Room
The **+** sits in the **Rooms** header of the chat history sidebar.
Search by name or email. Each person you select moves up to the invite list. Nothing exists
yet at this point, so you can still remove anyone or cancel.
Orion creates the room and opens it for you.
The **Start a room** button on the chat home screen opens the same dialog.
## Turn an Existing Chat Into a Room
Any solo chat becomes a room the moment you add someone to it.
Go to the chat you want to work on together.
On a solo chat the control is labeled **Share**.
Search by name or email and select them.
They join this conversation, not a copy of it, and they see everything already in it from the
beginning. Once the conversation is a room, the same control is labeled **People** and shows the
participants' avatars.
Adding someone exposes the whole transcript to them, including anything discussed before they
joined. The dialog warns you before you add.
## Finding Your Rooms
The chat history sidebar splits into two sections, **Rooms** and **Chats**. Room rows carry a stack
of participant avatars, so you can tell at a glance who is in each one. Five rooms show by default,
and **Show all** expands the rest.
## Who Can Add and Remove People
* **The conversation owner** adds and removes participants. Orion enforces this server side, so the
controls do not appear for anyone else.
* **Any participant** can leave. Open the three-dot menu on the room's row in the sidebar and choose
**Leave room**.
* **Tenant admins** can read a room they are not in, but cannot post to it. They see a banner saying
so instead of the chat input.
Leaving does not erase history. Your earlier messages stay in the transcript, attributed to you.
## Addressing Orion
In a room, Orion does not answer every message. You address it with `@orion`.
Type `@` in the chat input and pick **Orion** from the menu, or type `@orion` directly. The mention
renders as a chip in the sent message. Clicking a suggested follow-up or a recommendation inside a
room addresses Orion for you.
Orion is the only participant you can address this way. The rest of the `@` menu references content,
such as a metric or a wiki page, not people. To get a teammate's attention, write their name as
ordinary text.
## How Orion Responds
Rooms have two response modes. Change them in the **People** dialog, under **How Orion responds**:
| Mode | What Orion does |
| ---------------------------- | --------------------------------------------------------------------- |
| **When mentioned** (default) | Replies only when you `@orion`. |
| **Listening** | Replies when a message looks meant for it, and whenever you `@orion`. |
A new room starts in **When mentioned**, including a solo chat you have just added someone to. In
either mode, `@orion` always gets a reply.
Any participant can change the mode, and the change applies to everyone in the room. Viewers are
the exception: a Viewer can change it only in a room they own.
Solo chats work differently: Orion replies to every message, and the setting is not offered.
Each change is recorded in the room's timeline, so the transcript shows a notice like
"Priya set Orion to listening" at the point it happened.
## Replying to a Specific Message
Rooms add a **Reply** action to messages. Select the reply arrow on a message, and it appears as a
quote card above the chat input. The card stays on your message after you send it, so a busy room
still reads in order.
You cannot reply to your own message, or to a message that is still streaming.
## What You See While Orion Works
* **Typing indicators.** Avatars appear above the chat input while a teammate is typing, and while
Orion is working on a turn.
* **Everyone watches the same answer.** Participants see Orion's response, including notebook cells,
as it is generated, not after it finishes.
* **Streams survive a reload.** If your connection drops or you refresh mid-answer, you rejoin the
stream in progress. Opening a room while a turn is already running catches you up on it.
## Room Activity
Rooms show light activity notices inline in the transcript:
* "You started this room"
* "Priya added Marcus"
* "Marcus left this room"
* "Priya set Orion to reply only when mentioned"
A run of similar notices collapses into one line, such as "You added Dana plus 9 others",
with the full list on hover. Inviting ten people costs one line, not ten.
## Important Notes
* **Rooms cannot be forked** - the read-only copy link is offered on solo chats only
* **Attribution comes from the server** - names and avatars are resolved from the room's participant
list, not from anything the browser sends
* **Response mode is per room** - it does not change the defaults for your other conversations
* **Leaving preserves history** - your past messages stay in the transcript after you leave