roomote-community · Oct 26, 2026
@@ -274,6 +274,12 @@ service hook, Bitbucket needs commit-status webhook events and the Pipelines
 OAuth scope, and Gitea needs the `workflow_run` webhook event. CI Failure Triage
 is webhook-driven; a scheduled check does not scan repositories.
 
+**Run now** is also available. Each explicit run launches at most one
+investigation for the first eligible environment-mapped repository without an
+active triage claim; it is not a full scan of every repository. For GitLab, Azure
+DevOps, Bitbucket, and Gitea, Roomote first checks that repository's latest
+default-branch pipeline or build and skips it unless it failed.
+
 **Announce Roomote Updates** posts only after the deployment finishes readiness
 checks for a newer installed release. The first observation establishes a
 silent baseline, restarts and rollbacks do not repost, and patch-only changes

@@ -35,7 +35,10 @@ Before connecting a communications provider, make sure your deployment has:
 1. a stable public HTTPS URL when the provider uses callbacks or webhooks
 2. provider app or bot credentials
 3. at least one Roomote user who can sign in
-4. an environment that tasks can run against
+
+An environment is optional for conversations and repository-only tasks. Configure
+a [sandbox provider](/compute) when a request needs command execution; add an
+[environment](/environments) for reusable services, setup commands, or previews.
 
 After connecting the provider, start a small session from chat and confirm that:
 

@@ -66,12 +66,12 @@ Use environment variables when:
 - you want changes reviewed in infrastructure config
 - you need to prevent in-app overrides
 
-`/setup` also respects env-managed provider configuration. If an inference
-provider is fully configured from environment variables, setup skips the
-inference-provider step. If a hosted sandbox provider such as Modal, E2B, or
-Daytona is fully configured from environment variables, setup skips the sandbox
-provider step too. Local Docker is still treated as the default local fallback,
-so Docker-only configuration does not skip that step.
+`/setup` also respects env-managed provider configuration. The initial bootstrap
+establishes the administrator account and inference, then opens a setup
+conversation. Repository access and sandbox configuration are handled there as
+needed, rather than in a separate sandbox-provider wizard step. A configured
+provider can satisfy the capability without entering its credentials again;
+complete a real task to verify that it works.
 
 ## Production recommendations
 
@@ -260,7 +260,7 @@ manifest changes.
 
 | Env var                              | Required          | Used for                                                                                                                                 |
 | ------------------------------------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| `DEFAULT_COMPUTE_PROVIDER`           | Optional          | Runtime default sandbox provider when no admin default is saved. Supported values are `docker`, `modal`, `e2b`, `daytona`, `blaxel`, `box`, `azure`, and the Roomote Cloud-only `roomote`. |
+| `DEFAULT_COMPUTE_PROVIDER`           | Optional          | Runtime default sandbox provider when no admin default is saved. Accepted environment-variable values are `docker`, `modal`, `e2b`, `daytona`, `box`, `azure`, and the Roomote Cloud-only `roomote`. Select Blaxel through **Settings > Sandboxes** instead; the current deployment env validator does not accept `blaxel` here. |
 | `EXCLUDED_COMPUTE_PROVIDERS`         | Optional          | Comma-separated provider IDs to hide or exclude from default selection.                                                                  |
 | `DOCKER_WORKER_IMAGE`                | Optional          | Worker image used by Docker. In production, prefer an immutable registry-qualified tag.                                                  |
 | `ROOMOTE_WORKER_IMAGE_REPO`          | Optional          | Registry repository used to derive the worker image from `RELEASE_VERSION` when `DOCKER_WORKER_IMAGE` is unset.                          |
@@ -270,7 +270,7 @@ manifest changes.
 | `DOCKER_WORKER_CPU_LIMIT`            | Optional          | CPU limit per Docker task. Defaults to `2`.                                                                                              |
 | `DOCKER_WORKER_MEMORY_LIMIT`         | Optional          | Memory and memory+swap limit for each Docker worker. Defaults to `4g`.                                                                   |
 | `DOCKER_TASK_DAEMON_MEMORY_LIMIT`    | Optional          | Memory and memory+swap limit for the nested Docker daemon used by Docker-project tasks. Defaults to `8g`.                                |
-| `DOCKER_WORKER_PIDS_LIMIT`           | Optional          | Process limit per Docker task. Defaults to `512`.                                                                                        |
+| `DOCKER_WORKER_PIDS_LIMIT`           | Optional          | Process limit per Docker task. The runtime default is `2048`; the supplied production and Docker compute Compose files explicitly default it to `512`. Set it in the Compose environment file to override that value. |
 | `DOCKER_WORKER_DISK_LIMIT`           | Optional          | Writable-layer limit. Defaults to `20g`; tasks fail closed when the Docker storage driver cannot enforce it.                             |
 | `DOCKER_WORKER_ALLOW_UNBOUNDED_DISK` | Optional          | Explicitly permits startup without `--storage-opt size`. Defaults to `false`; use only with an equivalent host-level quota.              |
 | `DOCKER_WORKER_LOG_MAX_SIZE`         | Optional          | Maximum size of each Docker JSON log file. Defaults to `10m`.                                                                            |

@@ -1,7 +1,7 @@
 ---
 title: Asana
 description: Bring Asana project and task context into Roomote tasks.
-icon: 'https://api.iconify.design/simple-icons:asana.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/asana.svg?color=currentColor'
 ---
 
 Connect Asana when your team plans or tracks work there and you want Roomote to

@@ -1,7 +1,7 @@
 ---
 title: Better Stack
 description: Bring monitoring and incident context into Roomote tasks.
-icon: 'https://api.iconify.design/simple-icons:betterstack.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/betterstack.svg?color=currentColor'
 ---
 
 Connect Better Stack when investigations depend on logs, incidents, uptime

@@ -1,7 +1,7 @@
 ---
 title: Braintrust
 description: Give Roomote access to Braintrust prompts, runs, and results.
-icon: 'https://api.iconify.design/simple-icons:braintrust.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/braintrust.svg?color=currentColor'
 ---
 
 Connect Braintrust when your team evaluates prompts, runs, or model behavior

@@ -1,7 +1,7 @@
 ---
 title: Buildkite
 description: Inspect Buildkite pipelines, builds, jobs, and tests from Roomote tasks.
-icon: 'https://api.iconify.design/simple-icons:buildkite.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/buildkite.svg?color=currentColor'
 ---
 
 Connect Buildkite when tasks need CI pipeline, build, job, log, artifact, test,

@@ -1,7 +1,7 @@
 ---
 title: Cloudflare
 description: Inspect and operate Cloudflare resources from Roomote tasks.
-icon: 'https://api.iconify.design/simple-icons:cloudflare.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/cloudflare.svg?color=currentColor'
 ---
 
 Connect Cloudflare when tasks need account, zone, DNS, Workers, security, or

@@ -20,7 +20,7 @@ servers. Snippets that launch `mcp-remote` are converted to remote servers on
 the upstream URL, which keeps credentials behind the Roomote proxy and
 enables per-tool management.
 
-Three kinds of servers are supported:
+Four connection options are supported:
 
 | Kind                    | How it connects                                                            | Where credentials live                          |
 | ----------------------- | -------------------------------------------------------------------------- | ----------------------------------------------- |

@@ -1,7 +1,7 @@
 ---
 title: ElevenLabs
 description: Add voice narration to Roomote feature-demo videos.
-icon: 'https://api.iconify.design/simple-icons:elevenlabs.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/elevenlabs.svg?color=currentColor'
 ---
 
 Connect ElevenLabs when you want Roomote to add voice-over narration to

@@ -1,7 +1,7 @@
 ---
 title: Grafana
 description: Let Roomote inspect shared Grafana dashboards, alerting state, annotations, and data sources during a task.
-icon: 'https://api.iconify.design/simple-icons:grafana.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/grafana.svg?color=currentColor'
 ---
 
 Connect Grafana when your team uses it as the shared source of truth for

@@ -1,7 +1,7 @@
 ---
 title: Jira
 description: Bring Jira issue and project context into Roomote tasks.
-icon: 'https://api.iconify.design/simple-icons:jira.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/jira.svg?color=currentColor'
 ---
 
 Connect Jira when your team already tracks engineering work there and you want

@@ -1,7 +1,7 @@
 ---
 title: Linear
 description: Turn Linear issues into scoped Roomote work.
-icon: 'https://api.iconify.design/simple-icons:linear.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/linear.svg?color=currentColor'
 ---
 
 The Linear integration lets Roomote receive work from Linear, post progress back

@@ -1,7 +1,7 @@
 ---
 title: Neon
 description: Let Roomote inspect Neon databases during a task.
-icon: 'https://api.iconify.design/simple-icons:neon.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/neon.svg?color=currentColor'
 ---
 
 Connect Neon when Roomote needs direct database context from your Neon projects

@@ -1,7 +1,7 @@
 ---
 title: Notion
 description: Bring approved Notion pages and data sources into Roomote tasks.
-icon: 'https://api.iconify.design/simple-icons:notion.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/notion.svg?color=currentColor'
 ---
 
 Connect Notion when product specs, runbooks, notes, or operating context already

@@ -1,7 +1,7 @@
 ---
 title: PostHog
 description: Let Roomote inspect analytics, experiments, and error-tracking context from PostHog.
-icon: 'https://api.iconify.design/simple-icons:posthog.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/posthog.svg?color=currentColor'
 ---
 
 Connect PostHog when tasks depend on product analytics, feature flags,

@@ -1,7 +1,7 @@
 ---
 title: Railway
 description: Let Roomote inspect Railway projects and services during a task.
-icon: 'https://api.iconify.design/simple-icons:railway.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/railway.svg?color=currentColor'
 ---
 
 Connect Railway when your team runs services there and Roomote should be able to

@@ -1,7 +1,7 @@
 ---
 title: Resend
 description: Inspect and manage shared email infrastructure from Roomote tasks.
-icon: 'https://api.iconify.design/simple-icons:resend.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/resend.svg?color=currentColor'
 ---
 
 Connect Resend when tasks need email delivery status, received messages,

@@ -1,7 +1,7 @@
 ---
 title: Sentry
 description: Bring Sentry issue and performance context into Roomote tasks.
-icon: 'https://api.iconify.design/simple-icons:sentry.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/sentry.svg?color=currentColor'
 ---
 
 Connect Sentry when bug investigations depend on real error, alert, or

@@ -1,7 +1,7 @@
 ---
 title: Snowflake
 description: Let Roomote query and explore your Snowflake warehouse during a task.
-icon: 'https://api.iconify.design/simple-icons:snowflake.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/snowflake.svg?color=currentColor'
 ---
 
 Connect Snowflake when Roomote needs warehouse context to answer data-heavy

@@ -1,7 +1,7 @@
 ---
 title: Supabase
 description: Let Roomote inspect read-only database context from Supabase.
-icon: 'https://api.iconify.design/simple-icons:supabase.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/supabase.svg?color=currentColor'
 ---
 
 Connect Supabase when Roomote needs direct database context from a Supabase

@@ -1,7 +1,7 @@
 ---
 title: Vercel
 description: Let Roomote inspect shared Vercel teams, projects, deployments, logs, and domain availability during a task.
-icon: 'https://api.iconify.design/simple-icons:vercel.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/vercel.svg?color=currentColor'
 ---
 
 Connect Vercel when Roomote needs deployment, project, or runtime context that

@@ -1,7 +1,7 @@
 ---
 title: X
 description: Let Roomote search public X posts and look up users, trends, and news during a task.
-icon: 'https://api.iconify.design/simple-icons:x.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/x.svg?color=currentColor'
 ---
 
 Connect X when Roomote needs public X context: what people are saying about a

@@ -49,8 +49,8 @@ Connecting an API-key provider that has no configured models yet automatically
 adds a short list of recommended models for it — enabled and including the
 provider's default model — so you land on a usable model list right away, both
 in the setup wizard and from **Settings > Models**. You stay in control: you
-can disable or remove any of the added models, add more later, and reconnecting
-a provider never re-adds models you removed.
+can disable recommendations and add more models later. Recommended models stay
+listed while their provider is connected; custom models can be removed.
 
 When you connect or update an API-key provider, Roomote first checks the
 submitted credentials with a small live model request. If the provider rejects

@@ -1,6 +1,6 @@
 ---
 title: Discord
-icon: 'https://api.iconify.design/simple-icons:discord.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/discord.svg?color=currentColor'
 description: Configure a Discord bot so Roomote can start and continue tasks in DMs, channels, threads, and forums.
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: Microsoft Teams
-icon: 'https://api.iconify.design/simple-icons:microsoftteams.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/microsoftteams.svg?color=currentColor'
 description: Configure Microsoft sign-in and Microsoft Teams bot messaging for Roomote.
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: Slack
-icon: 'https://api.iconify.design/simple-icons:slack.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/slack.svg?color=currentColor'
 description: Configure Slack sign-in, Slack app callbacks, events, and interactivity for Roomote.
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: Telegram
-icon: 'https://api.iconify.design/simple-icons:telegram.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/telegram.svg?color=currentColor'
 description: Configure a Telegram bot and webhook so Roomote can start and continue tasks from Telegram.
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: Docker
-icon: 'https://api.iconify.design/simple-icons:docker.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/docker.svg?color=currentColor'
 description: Run Roomote task sandboxes as Docker containers on the same host as the deployment.
 ---
 
@@ -40,7 +40,7 @@ DOCKER_WORKER_RELEASE_PATH=/roomote/releases/worker-current.tar.gz
 DOCKER_WORKER_CPU_LIMIT=2
 DOCKER_WORKER_MEMORY_LIMIT=4g
 DOCKER_TASK_DAEMON_MEMORY_LIMIT=8g
-DOCKER_WORKER_PIDS_LIMIT=512
+DOCKER_WORKER_PIDS_LIMIT=2048
 DOCKER_WORKER_DISK_LIMIT=20g
 DOCKER_WORKER_ALLOW_UNBOUNDED_DISK=false
 DOCKER_WORKER_LOG_MAX_SIZE=10m
@@ -76,11 +76,15 @@ the same task-scoped routing, while their Docker control plane is not exposed
 to other tasks. The daemon, inner containers, network, and workspace volume are
 stopped or removed with the task lifecycle.
 
-Workers default to 2 CPUs, 4 GiB of memory with no additional swap, 512 PIDs,
+Workers default to 2 CPUs, 4 GiB of memory with no additional swap, 2048 PIDs,
 a requested 20 GiB writable-layer quota, and three 10 MiB JSON log files. The
 dedicated Docker daemon used by Docker-project tasks receives an 8 GiB memory
 limit by default while inheriting the other worker resource limits. The
 variables above can tune those bounds.
+The supplied production and Docker compute Compose files explicitly set a
+512-PID default. Set `DOCKER_WORKER_PIDS_LIMIT=2048` in the Compose environment
+file and recreate the controller when browser-heavy tasks need more headroom;
+new task containers receive the updated limit.
 Writable-layer quotas require a Docker
 storage driver that supports `--storage-opt size`. When the driver rejects that
 option, Roomote refuses to start the task rather than allowing untrusted code to
@@ -172,7 +176,7 @@ one to a fix.
   sandbox needs. Stop it, or change the conflicting service's port, then retry.
 - **The worker release archive is missing.** The Docker provider installs the
   worker from a local release archive. For local development, run
-  `pnpm dev --use-release` (or the worker-release build step) so the archive
+   `pnpm dev` (or the worker-release build step) so the local archive
   exists before starting tasks.
 - **The worker failed while contacting the Roomote API (`fetch failed`).**
   The container cannot reach the API URL from inside Docker. Verify

@@ -1,6 +1,6 @@
 ---
 title: Modal
-icon: 'https://api.iconify.design/simple-icons:modal.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/modal.svg?color=currentColor'
 description: Run Roomote tasks on Modal-hosted sandboxes with snapshot support.
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: GitHub Copilot
-icon: 'https://api.iconify.design/simple-icons:githubcopilot.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/githubcopilot.svg?color=currentColor'
 description: Use models included with an eligible GitHub Copilot account in Roomote.
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: OpenCode Zen
-icon: 'https://api.iconify.design/simple-icons:opencode.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/opencode.svg?color=currentColor'
 description: Use OpenCode's routed Zen model service with Roomote.
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: Vercel AI Gateway
-icon: 'https://api.iconify.design/simple-icons:vercel.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/vercel.svg?color=currentColor'
 description: Route Roomote model calls through Vercel AI Gateway.
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: Azure DevOps
-icon: 'https://api.iconify.design/simple-icons:azuredevops.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/azuredevops.svg?color=currentColor'
 description: Configure Azure DevOps repository sync for Roomote.
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: Bitbucket Cloud
-icon: 'https://api.iconify.design/simple-icons:bitbucket.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/bitbucket.svg?color=currentColor'
 description: Configure Bitbucket Cloud repository sync and pull request webhooks and pipeline failure triage for Roomote.
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: Gitea
-icon: 'https://api.iconify.design/simple-icons:gitea.svg?color=currentColor'
+icon: 'https://api.iconify.design/simple-icons/gitea.svg?color=currentColor'
 description: Configure Gitea repository sync, pull request webhooks, and Actions failure triage for Roomote.
 ---