# Roost documentation

Roost gives your AI agents a place to keep working. Each agent has its own
purpose, conversation, files, and memory. You run Roost on your own host and
connect it to Codex.

## Start here

- [Choose a deployment platform](https://docs.tryroost.dev/deployment.md) — start with exe.dev, or find the right path for your host.
- [Read with an agent](https://docs.tryroost.dev/for-agents.md) — plain Markdown, llms.txt, and a deployment prompt.
- [Getting started](https://docs.tryroost.dev/getting-started.md) — connect Codex and create your first agent.
- [Install and operate Roost](https://docs.tryroost.dev/install.md) — Linux installation, private access,
  updates, and recovery.
- [Agents and memory](https://docs.tryroost.dev/agents-and-memory.md) — shape an agent's behavior and
  understand what persists between conversations.

## Work with your agents

- [Automations](https://docs.tryroost.dev/automations.md) — recurring work, timezones, quiet updates, and run history.
- [Delegation](https://docs.tryroost.dev/delegation.md) — let agents hand a focused task to a specialist.
- [Files and approvals](https://docs.tryroost.dev/files-and-approvals.md) — upload inputs, download results,
  and review actions that need your permission.
- [Dashboards](https://docs.tryroost.dev/dashboards.md) — keep saved trackers, notes, and charts outside chat.
- [Shared computer](https://docs.tryroost.dev/computer.md) — watch browser work and take control of the desktop.
- [Push notifications](https://docs.tryroost.dev/notifications.md) — receive results and approval requests on your devices.
- [Mobile access](https://docs.tryroost.dev/mobile.md) — add Roost to your home screen.

## Build and operate

- [Development](https://docs.tryroost.dev/development.md) — run from source, contribution conventions, and packaging.
- [Public websites](https://docs.tryroost.dev/public-sites.md) — build and host the marketing and documentation sites separately.
- [Architecture](https://docs.tryroost.dev/architecture.md) — application structure, Codex integration, and storage.
- [Remote desktop setup](https://docs.tryroost.dev/remote-desktop-setup.md) — provision a persistent Linux desktop.
- [Conversation performance](https://docs.tryroost.dev/chat-performance.md) and [PWA startup](https://docs.tryroost.dev/pwa-startup.md)
  — implementation notes and measured results.

## Deployment model

Roost is a single-user app. The packaged server listens on loopback and has no
application-level authentication. Use an SSH tunnel or a reverse proxy that
authenticates both HTTP and WebSocket connections. Its public marketing and
documentation sites can be hosted separately from this private app.

Work runs on the server, so closing a browser does not stop it. Roost and its
host must stay running for scheduled tasks and notifications. Agent memory and
sessions are stored separately, while the operating-system account, connected
accounts, and configured desktop are shared.