Project Sharing
- Desktop app
- All plans
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..."). Under that text, Publish the project to your team instead. opens the Team card, for a teammate who should work on their own computer.
- Member: the Shared with me section of the sidebar (in non-dev mode, right under the name of your room), 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
- 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.
- 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.
- 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.
- 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.
- 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
- Free, Plus and Pro share a project with one person; the Team plan removes the ceiling ("Unlimited project sharing"). Since 2026-10-21 (it was 2, 3 and 5): invitations made before keep working, only new ones are checked. When the limit is reached, the invite form says so and offers See the Team plan.
- 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.
- Shared projects are listed in the full sidebar only, not in the folded narrow rail.
- 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. Back returns to your own projects.
- I accepted the invitation but the project does not show up. It appears under Shared with me a few seconds after Accept, in developer mode as in non-dev mode (there, right under the name of your room). Accepted from the email link: come back to the app, it syncs as soon as the window is in front again (at the latest within two minutes). If the sidebar is folded into its narrow rail, unfold it: shared projects are only listed in the full sidebar. Still missing: check that the app is signed in with the account that received the invitation.
- 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.
- Why can I only invite one person to my project? Free, Plus and Pro share a project with one person. To work with more people, the Team plan has no ceiling (the invite form links to it).
- I want my teammate to use my agents, prompts and skills on their own computer, with their own AI accounts. Is this the right feature? No: here everything runs on your machine, with your accounts, and a member sees them. Publish the project to your team instead (Settings > Account > Team > Team projects, see Team Plan).
- 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: the single-account version, your own machines.
- Team Plan: lifts the member ceiling, and publishes a project so each teammate works on their own computer.
- Team Shared Library: sharing commands and connections rather than a live project.
- Sketch, Screenshot to Agent: the attachments a member can send.