# Lobby Docs

> Work with AI agents and teammates on shared GitHub repositories.

## Cloud Agents

- [Overview](https://docs.joinlobby.dev/): Run cloud agents against shared GitHub repositories and review their work.
- [Setup](https://docs.joinlobby.dev/quickstart): Connect GitHub and take your first task through review.
- [Conversations and workspaces](https://docs.joinlobby.dev/conversations): Give agents context, collaborate, and resume work.
- [Capabilities](https://docs.joinlobby.dev/capabilities): Understand what Lobby cloud agents can do inside an authorized repository.
- [Best Practices](https://docs.joinlobby.dev/best-practices): Give cloud agents clear work, bounded authority, and verifiable completion criteria.
- [Projects And Tasks](https://docs.joinlobby.dev/projects-tasks): Coordinate durable cloud-agent work across conversations and teammates.
- [Builds And Services](https://docs.joinlobby.dev/development-environments): Give managed services write-only environment values and renewable AWS access.
- [Review And Publish](https://docs.joinlobby.dev/source-control): Inspect the right worktree, commit reviewed files, and publish to GitHub.
- [Demo Evidence](https://docs.joinlobby.dev/demos): Share a recording of a changed interaction with your team.

## Teams and enterprise

- [Teams and enterprise](https://docs.joinlobby.dev/teams-enterprise): Roll out Lobby with clear identity, repository, workspace, and security boundaries.
- [Identity and access](https://docs.joinlobby.dev/identity-access): Understand Lobby accounts, team roles, GitHub authorization, and revocation.
- [Security and connectivity](https://docs.joinlobby.dev/security-connectivity): Evaluate Lobby's workspace isolation, credentials, storage, regions, and network limits.

## API

- [Overview](https://docs.joinlobby.dev/api): Automate Lobby cloud agents through the authenticated CLI and MCP server.
- [Authentication](https://docs.joinlobby.dev/api/authentication): Sign in to Lobby automation without copying browser cookies or agent capabilities.
- [List Conversations](https://docs.joinlobby.dev/api/list-conversations): List cloud-agent conversations visible to the signed-in account and GitHub identity.
- [List Agents](https://docs.joinlobby.dev/api/list-agents): List agents working in the selected repository scope.
- [Read A Chat](https://docs.joinlobby.dev/api/read-chat): Read bounded text from another visible cloud-agent conversation.
- [Get Project](https://docs.joinlobby.dev/api/get-project): Read the project brief and current conversation task link.
- [Save Project](https://docs.joinlobby.dev/api/save-project): Replace the current project's durable Markdown brief.
- [List Tasks](https://docs.joinlobby.dev/api/list-tasks): Find tasks in the current cloud-agent project.
- [Get A Task](https://docs.joinlobby.dev/api/get-task): Read one task's description, state, owner, and revision.
- [Save A Task](https://docs.joinlobby.dev/api/save-task): Create a task or update one with revision safety.
- [List Comments](https://docs.joinlobby.dev/api/list-comments): Read task progress, blockers, verification, and handoff history.
- [Save A Comment](https://docs.joinlobby.dev/api/save-comment): Append progress, verification, blocker, or handoff context to a task.
- [List Task Statuses](https://docs.joinlobby.dev/api/list-task-statuses): List the fixed status values accepted by cloud-agent tasks.
- [Link A Task](https://docs.joinlobby.dev/api/link-task): Associate the current cloud-agent conversation with its primary task.
- [List Claims](https://docs.joinlobby.dev/api/list-claims): List active advisory file claims in the selected repository.
- [Acquire A Claim](https://docs.joinlobby.dev/api/acquire-claim): Claim one exact repository-relative file path before editing.
- [Release A Claim](https://docs.joinlobby.dev/api/release-claim): Release a file claim owned by the current cloud-agent run.
- [Guard A File](https://docs.joinlobby.dev/api/guard-file): Check or create the short-lived claim used by Lobby's guarded writer.
- [Upload A Demo](https://docs.joinlobby.dev/api/upload-demo): Publish a reviewed MP4 or WebM as private repository-scoped evidence.
- [Open A Demo](https://docs.joinlobby.dev/api/open-demo): Open a Lobby demo viewer URL in the existing browser tab.
- [Delete A Demo](https://docs.joinlobby.dev/api/delete-demo): Remove a demo when permanent evidence is intentionally withdrawn.
- [Run With Approval](https://docs.joinlobby.dev/api/run-with-approval): Request exact sensitive scope, then run one command in a fresh sandbox.
- [MCP Setup](https://docs.joinlobby.dev/api/mcp): Expose Lobby project tools and demo uploads to local MCP clients.

## Reference

- [For agents](https://docs.joinlobby.dev/agents): Read Lobby documentation and return verifiable work.

## Other

- [CLI reference](https://docs.joinlobby.dev/api/cli): Discover conversations, read project work, coordinate agents, and publish demo evidence.