# Project Sharing

> The owner of a project invites other AgentsRoom accounts to it.

- Area: Desktop app
- Plans: All plans
- Last checked against the product: 2026-09-08
- Web page: https://agentsroom.dev/docs/project-sharing

## What it does

The owner of a project invites other AgentsRoom accounts to it. A member sees the project in their own app under **Shared with me**, watches the owner's agents live, types into their sessions and, depending on the access granted, creates and launches agents on the owner's machine. The owner's computer acts as a small local server for a team of two or three; everything travels end-to-end encrypted through the relay, and the owner's machine keeps the final say on what runs. Two access levels: **Whole project** (view, run and create agents) and **Specific agents** (attach only to the agents listed).

## Where to find it

- Owner: **Project settings > Team access** (section "Invite other AgentsRoom accounts to this project...").
- Member: the **Shared with me** section of the sidebar, and the invitation card that appears in the app ("{owner} invited you to the project {project}", **Accept** / **Decline**). The invitation also arrives by email.
- Inside a shared project the header shows **Shared by {owner}, running on {device}**.

## How to use it

1. As owner, open Project settings > Team access, type the **Email or pseudonym of their AgentsRoom account**, choose **Whole project** or **Specific agents** (then tick the agents), and click **Send invitation**. The member appears as **Pending**, then **Active** once accepted.
2. As member, click **Accept** on the card (or open the link in the email; you are asked to sign in with the invited address). The project appears under Shared with me.
3. Open it: the owner's agents show live. Type in a terminal to drive an agent; with Whole project access, add an agent as in your own project. It starts on the owner's machine.
4. The member's composer bar under the remote terminal offers Sketch, a region screenshot and file attachments: the bytes travel to the owner's machine and land in the agent as if dropped there.
5. To end access: owner **Edit** or **Revoke access** in Team access; member leaves from the same card. A revoked project closes on the member's side.

If the owner's machine is off, the row stays clickable and the room says **Waiting for {owner}'s machine**; it connects on its own when AgentsRoom runs there. **Check again** forces a refresh.

## Settings

None.

## Agent tools (MCP)

None.

## Providers

All providers, no difference: the member drives whatever CLI the owner's agents run on.

## Mobile

Not on the mobile companion: shared projects are not listed on the phone.

## Limits

- Each project has a member ceiling on Free, Plus and Pro; the Team plan removes it ("Unlimited project sharing").
- The owner's machine must be on with AgentsRoom running; after an accept, the owner's app can take up to two minutes to open the room.
- One remote controller per agent session at a time; the owner does not see the member's presence.
- Remote attachments are capped in size per file.
- Sharing is indexed on the project identity stored in the repository, so clones of the same repo open the same shared project; a folder copied from another project can inherit that identity and is re-keyed on detection.
- Cannot invite yourself or the same person twice.

## Common questions

- **The shared project is grey and does nothing.** The owner's machine is offline, has not synced yet (up to two minutes), or no longer lists the project. The room explains which; ask the owner to open it again or reshare.
- **Can the member see my whole disk?** No. Only the shared project, and only the agents you granted with Specific agents.
- **Does it cost the member anything?** No plan is required to accept an invitation; the owner's plan sets the member ceiling.
- **Is this the Remote Fleet?** Same mechanism, other people: Remote Fleet is your own machines, project sharing is other accounts on your project.

## Related

- [Remote Fleet](https://agentsroom.dev/docs/remote-fleet.md): the single-account version, your own machines.
- [Team Plan](https://agentsroom.dev/docs/team-plan.md): lifts the member ceiling.
- [Team Shared Library](https://agentsroom.dev/docs/team-shared-library.md): sharing commands and connections rather than a live project.
- [Sketch](https://agentsroom.dev/docs/sketch.md), [Screenshot to Agent](https://agentsroom.dev/docs/screenshot-to-agent.md): the attachments a member can send.