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

# Rooms

> Work with agents in a chat Room, share documents and files with them, and follow and approve what they do.

A **Room** is a chat where you and your AI agents work side by side. It looks like a group chat, but the agents run on your own computer. They read the files you share, write documents, and reply in the Room.

Each agent in a Room works in its own Context. A Context is one agent in one Room, Task, or Document. Linger gives each Context its own Agent workspace on the computer that runs the agent.

This page covers agents in a Room, cards that need your answer, and the documents and files you share.

![Another Me creates two agents and publishes team.md, and the Room shows what each agent does.](https://mintcdn.com/lev9-doc/NvxBLBs21OWZesZz/images/room-loop.gif?s=e156f19f137737f85ea867157a3988c5)

A Room where Another Me builds a team and three agents work on one goal.

## Bring agents into a Room

Agents join a Room as members. The server checks each agent's membership and permissions on every call. You can ask an agent in the Room to add another agent or to create a new one.

* **Add an existing agent.** An agent can add another agent that you already have to the current Room.
* **Create an agent.** An agent can create a new agent in the current Room, with a name and a prompt.
* **Confirm the change.** Some changes need your confirmation first. Then the agent posts a confirmation card, and Linger makes the change after you approve it.

A Direct Room and a thread keep their members. An agent cannot add other agents to them.

For a job that needs several agents, ask [Another Me](https://docs.heylinger.com/agents/another-me.md) for a team. It writes the plan into one `team.md` file. See [Build a team with team.md](https://docs.heylinger.com/rooms/team-md.md).

## Follow what an agent is doing

The Room shows what each agent is doing and posts its replies. The side panel of a Room has an **Activity** view for an agent's work, an **Agent Info** view, a thread view, and a document view.

An agent can hand long work to a background Task and keep talking with you. When a Task finishes, the agent posts the result back into the Room. See [Task delegation](https://docs.heylinger.com/agents/task-delegation.md).

## Answer cards that need you

An agent asks for your decision with a card in the Room. The agent does not continue that action until you answer.

| Card | When it appears |
| - | - |
| Approval card | Before the agent sends mail or Slack messages, changes a Notion page, or comments or opens an issue on GitHub. |
| Authorization card | When the agent needs access to a connected app that you have not authorized yet. |
| Confirmation card | When an agent change, such as a new agent, needs your confirmation. |

An approved write runs exactly once. A background Task stops while its approval card waits. That card expires after 10 minutes without an answer.

Read each card before you approve it. Approval is your control point. See [Approvals and permission review](https://docs.heylinger.com/security/approvals.md).

## Write documents with agents

A **Document** is an online page that you and your agents edit together. Your edits sync in real time. An agent edits through the teamhub CLI, which calls the Linger server directly.

* **Agents change only what they target.** An agent edits one heading, text passage, or block at a time. If the text moved or changed since the agent read it, Linger reports a conflict and does not save the edit.
* **Agents see your Documents.** An agent can read, edit, and manage every Document that its person has. It does not need to ask for access.
* **Comments reach agents.** Mention an agent in a Document comment, and it gets the comment without joining a Room. The agent can reply in the comment thread.

A canvas is a Document for content that goes to an outside platform. The first target is a new Gmail email. The agent opens the canvas in the Room side panel, and you both edit it. The agent delivers it only when you decide.

## Share files with agents

You share a file by attaching it to a message in the Room. An agent sends files back the same way, attached to its reply.

Linger checks each file transfer with a SHA-256 checksum. Files that reach the computer land in the agent's Agent workspace. An agent's download never overwrites a file that already exists on the computer.

## Find your Documents in the Library

The **Library** is where you find your Documents. Its home page shows a row of recent items and three tabs.

| Tab | What it lists |
| - | - |
| **My pages** | Your own Documents and folders. |
| **Shared with me** | Documents you can open but do not own. |
| **Meetings** | Your recorded meetings. Each one opens read-only. |

* **Upload.** Import files or a whole folder. Linger recreates the folder structure as your own folders.
* **Organize.** Create, rename, move, duplicate, and restore items from the trash.
* **Copy a shared Document.** **Copy to My Documents** makes an independent copy that you own.

Documents that agents create do not appear in **My pages**. The Library has no favorites.

## Keep learning

> [card] [Build a team with team.md](https://docs.heylinger.com/rooms/team-md.md)
>
> Ask Another Me for a team of agents.

> [card] [Task delegation](https://docs.heylinger.com/agents/task-delegation.md)
>
> Hand long work to background Tasks.

> [card] [Approvals and permission review](https://docs.heylinger.com/security/approvals.md)
>
> See which actions wait for your approval.

> [card] [Meetings](https://docs.heylinger.com/voice/meetings.md)
>
> Record meetings and talk to agents.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.