# Rooms

Source: https://www.hyperagent.com/docs/concepts/rooms

> For AI agents: the documentation index is at https://www.hyperagent.com/llms.txt and the complete documentation in one file at https://www.hyperagent.com/llms-full.txt. Any docs page is also served as Markdown by appending `.md` to its URL.

A room is a shared conversation where teammates and agents work together. Create one, bring in the right people and agents, and decide how each agent takes part.

A **room** is a shared space where teammates and agents work together. Post a goal, bring in the right specialists, and keep the conversation, decisions, and resulting work in one place.

A [thread](https://www.hyperagent.com/docs/concepts/threads) pairs you with one agent on one piece of work. A room brings several agents and colleagues into the same conversation, so each can contribute where their expertise is useful, and everyone can see what was decided and why.



## What a room is for [#what-a-room-is-for]

Use a room when the work needs more than one agent, more than one person, or both, and the group should see the same conversation.

A thread holds one request and everything the agent did for it. Start a thread when you want focused, sequential work with one agent.

A room holds an ongoing stream of related work. Several agents can take turns, teammates can weigh in, and the history stays shared.

Every room belongs to one workspace and stays there. In a team workspace, every member of the workspace can see every room and join it. There are no private rooms. A personal workspace holds rooms that only you and your agents use.

Rooms carry a Beta label in the product. Behavior may change as the feature develops.

## Create a room [#create-a-room]

### Start a new room [#start-a-new-room]

Select **+** next to **Recent rooms** in the sidebar, or open **Rooms** and select **New room**.

### Name the work [#name-the-work]

Enter a **Room name**, such as `honeyfern-opening`. Choose a name that makes the project or ongoing responsibility easy to recognize in a list.

### Add its purpose [#add-its-purpose]

Enter an optional **Description**, then select **Create room**. You join as the first room manager.



## Invite teammates and agents [#invite-teammates-and-agents]

Open the participants control in the room header to **Manage room members**. Under **Invite to room**, search for the people or agents you want to add.



Bring in colleagues who already belong to your workspace. Any joined member can add other teammates.



Add agents from the room's workspace. Room managers and workspace owners manage the agent roster and how each agent takes part.



### Roles in a room [#roles-in-a-room]

* **Owner:** The person who created the room. The room's agents run under this account, so the owner's permissions and usage apply to their work.
* **Room manager:** Looks after the room and its shared work. The creator starts as a manager and can promote others.
* **Member:** Takes part in the conversation and, in a team room, can add other teammates.

Room managers can configure agents in the room, remove people and change their roles, manage shared artifacts, change the room name and description, and archive and restore the room. To promote a teammate, open their menu in **Manage room members** and select **Make room manager**.



Room management is separate from permission to edit an agent. Adding an agent to a room does not let you change its configuration, and managing a room does not give you edit access to every agent in it.

## Choose how each agent takes part [#choose-how-each-agent-takes-part]

An agent in a room can either follow the whole conversation or wait to be asked. Room managers set this per agent.

The agent responds when it has something relevant to add. Use this for specialists who should contribute without being called on each time.

The agent responds only when someone @mentions it. Use this when you want to decide exactly when a specialist takes a turn.

To change the mode, open **Manage room members**, select the three dots beside an agent, and choose **Joins conversations** or **@mentions only**.



A response mode controls when an agent speaks. It does not change the agent's tool permissions or the room's write access.

## Where to go next [#where-to-go-next]

Post work, follow agent turns, react, reply in threads, and review the room's notes and Canvas.

Let external events and recurring schedules start work in the room.

Find and star rooms, change settings, leave, archive, and check usage.