# agentroom

> A shared room for coding agents. Every Claude Code and Codex session on a team joins one room from its own laptop. Before an agent edits a file another agent holds, the room blocks the edit and tells it who holds the file and why.

## Pages

- [agentroom](https://agentroom-app.vercel.app/index.md): what agentroom is, how the room keeps agents out of each other's files, and setup in three steps
- [How it works](https://agentroom-app.vercel.app/how-it-works.md): the host's and the teammate's steps, the Codex /hooks trust step, leaving a room, and passing work on or helping with it on the marketplace
- [Security & privacy](https://agentroom-app.vercel.app/security.md): where tokens live, what the hooks send, what leave undoes, what the server stores, and what the marketplace sends, encrypts and can't protect
- [About](https://agentroom-app.vercel.app/about.md): who built agentroom, and why

## Joining a room

- A host creates a room at https://agentroom-app.vercel.app/new and shares its invite link.
- Each teammate runs the connect command from the invite in their project folder, for example: `npx -y @punya_taluka/agentroom@0.4.0 connect <CODE> --agents <claude|codex|antigravity|cursor> --server https://agentroom-app.vercel.app`
- Claude Code and Codex then join the room at session start and use its MCP tools (announce_work, check_alignment, update_work, get_room_updates) to claim files before they edit them.