Architecture

This page is for contributors and operators who need a quick map of the source tree. It is intentionally high level. Public docs should explain how to run, configure, and use Roomote. Roomote is a pnpm + Turborepo monorepo with applications under apps/ and shared libraries under packages/.

Applications

App	Description
`apps/web`	Next.js web dashboard for setup, settings, tasks, and review.
`apps/docs`	Mintlify public documentation site published at `docs.roomote.dev`.
`apps/api`	Hono API server: webhooks, MCP and task-control routes, artifact APIs, backend tRPC.
`apps/controller`	Worker-dispatch control plane: dequeues jobs and launches sandbox workers.
`apps/worker`	Task runtime that runs inside each sandbox and executes the agent.
`apps/bullmq`	Background workers, scheduled jobs, and the opt-in Discord Gateway supervisor.
`apps/discord-gateway`	Reusable Discord Gateway connection and durable inbound-delivery subsystem.
`apps/preview-proxy`	Reverse proxy that exposes live previews from task sandboxes.
`apps/dev`	Local dev CLI that orchestrates the PM2-managed services (`pnpm dev`).

Packages

Package	Description
`packages/cloud-agents`	Agent definitions, prompt assembly, routing, workflows, and skills.
`packages/db`	Drizzle ORM schema and migrations.
`packages/sdk`	Shared contract between API, controller, and worker.
`packages/auth`	Authentication and session handling.
`packages/compute-providers`	Sandbox provider integrations.
`packages/github`, `gitlab`, `gitea`, `ado`, `bitbucket`	Source-control provider integrations.
`packages/slack`, `linear`, `communication`	Conversation-surface and issue-tracker integrations.
`packages/redis`, `env`, `types`, `feature-flags`	Shared infrastructure utilities.

Request flow

A task is created from the web dashboard, Slack, or another entry surface.
The API records it and enqueues work; the controller dequeues and provisions a sandbox with the selected sandbox provider.
The worker runs inside the sandbox, executes the agent against your repositories, and streams progress back.
Live previews from the sandbox are exposed through the preview proxy, and results are delivered back to the surface that started the task.

For local setup, see Local development. For running a deployment, see Self-hosting.

Getting Started

Using Roomote

Cookbook

Provider Configuration

Integrations

Roomote Configuration

Development

Applications

Packages

Request flow

​Applications

​Packages

​Request flow

Applications

Packages

Request flow