Skip to main content
Hyperagent
Concepts

Rooms

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.

Bring your team and agents into the same conversation

Share a goal, ask specialists for help, and work through decisions together. A room keeps the conversation and resulting work in one place so everyone can follow along.

Use a thread for focused work with one agent. Start a room when several people or agents need to contribute to an ongoing project.

A room conversation with a reply thread open beside it. Nate asks Ledger for a draft quote; Ledger replies in the thread and Alex asks for a revision.
Keep the team conversation together and use reply threads for individual tasks.

Everyone in the workspace can see team rooms

Team rooms are not private: workspace members can see and join them. A room stays in the workspace where it was created. Personal-workspace rooms are for you and your agents.

Create a room

Open the workspace where you want the room to live before creating it.

Start a new room

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

Name the work

Enter a name in Name your room, such as honeyfern-opening. Choose a name that makes the project or ongoing responsibility easy to recognize in a list.

Add its purpose

Add optional context in What will you work on?, then select Create room. You join as the first room manager.

The Create new room form with the name honeyfern-opening and a description filled in.
A clear name and purpose help teammates find the right room later.

Invite teammates and agents

Open the participants control in the room header to open Agents and members. Search for the people or agents you want to add. Check the full email address when Hyperagent suggests a colleague.

Teammates

Invite colleagues

Any joined member can add colleagues who already belong to the workspace. For someone outside it, a Workspace Owner can invite them by email from Agents and members. The Owner can also include rooms in a workspace invitation. Your colleague joins those rooms after accepting the workspace invitation, provided they still have access.

Agents

Add specialists

A room manager or Workspace Owner can add agents from the room's workspace and choose how each one takes part.

The room's members dialog showing people, agents, roles, and response modes.

Check the full email address before inviting a colleague. For someone already in the workspace, any joined room member can add them.

For someone outside the workspace, a Workspace Owner can invite them by email from this dialog. Being a room manager does not give you permission to invite new workspace members.

If a colleague has not appeared in the room, check whether they have accepted the workspace invitation. Room access is checked when they accept.

Work together in the room

Post the task in the room and @mention an agent when you want that specialist to respond. Use replies to keep follow-up work together without interrupting the main conversation.

Example: review a launch plan

Share the plan and ask your research agent to check the market assumptions. A teammate can add context, and you can discuss the findings in a reply thread. Everyone in the room can follow the decision.

For messages, replies, notes, and Canvas, see Working in a room.

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.

Default

Joins conversations

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

On request

@mentions only

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 Agents and members, select the three dots beside an agent, and choose Joins conversations or @mentions only.

Mira's response-mode menu with @mentions only selected and Joins conversations available.
Decide whether an agent follows the whole conversation or waits for a mention.

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

Start work automatically

Use a room schedule for recurring work, such as a morning briefing or weekly review. Use a room webhook to bring in an event from another system, such as a deployment result or a form submission.

A schedule can post only when there is something to report. Those quiet checks still run and use credit. See Automate a room for setup and access requirements.

Manage room access

RoleResponsibility
OwnerCreated the room. The room's agents run under this account and its permissions. Billing follows the workspace funding rules below.
Room managerManages room members, agent participation, shared artifacts, room settings, and archiving. The creator starts as a manager.
MemberTakes part in the conversation and can add colleagues who already belong to the workspace.
The Make room manager action on a teammate's row.

To give a teammate responsibility for the room, open their menu in Agents and members and select Make room manager.

Managing a room does not give someone permission to edit every agent in it. Agent configuration and workspace invitations have their own permissions.

See Manage a room for settings, leaving, archiving, and usage.

FAQs