Project console

Smooth Operator

smooth-operator/smooth-operator

6 agent profiles
Raw0
Grooming0
Needs Info0
Ready0
Review0
Fixed0
New bugs this week0
Groomed this week0
Verifier pass rate0%
Request changes0%

Setup actions

External setup needed

completedowner

Create the smooth-ctl GitHub App

Blocking: GitHub installation and repo sync

The smooth-ctl GitHub App has been created. Keep the app configured with selected repository installation, webhook secret, and V1 repo permissions.

github app createmanual
Open setup
openowner

Store the smooth-ctl GitHub App private key

Blocking: GitHub installation token minting

Generate or download the smooth-ctl private key in GitHub, then store it as GITHUB_APP_PRIVATE_KEY in Vercel and the Fly worker secret store. Do not paste the key into chat or commit it.

github app private key configuresecret presence check
Open setup
openowner

Store the smooth-ctl webhook secret

Blocking: GitHub webhook verification

Store the GitHub App webhook secret as GITHUB_WEBHOOK_SECRET in the Vercel control plane and ensure GitHub sends webhooks to the Smooth Operator webhook route.

github app webhook secret configuresecret presence check
Open setup
openowner

Install smooth-ctl on selected organization repositories

Blocking: GitHub issue and pull request mirroring

Install smooth-ctl on the selected organization repositories used for dogfooding. Smooth Operator will mark this complete when an installation webhook is received.

github app installwebhook seen
Open setup
openowner

Configure Vercel control-plane environment variables

Blocking: Web/API control plane deployment

Configure APP_URL, database, Redis, session, GitHub App, Telegram, and object storage variables in Vercel. Secret values should stay in Vercel or an approved secret manager.

vercel env secret configuresecret presence check
openowner

Create a narrow Fly token for the worker

Blocking: Ephemeral Fly runner Machines

Create a Fly org or deploy token for the worker. Store it as FLY_API_TOKEN in the worker environment only. Runner machines must not receive this token.

fly token configureapi check
Open setup
openadmin

Deploy the Fly runner app image

Blocking: Agent, verifier, and AI tester execution

Deploy the stable smooth-operator-runner-prod Fly app and publish the runner image. Jobs will create one Machine per execution under this app.

fly runner app deploysmoke test
openadmin

Configure S3/R2-style object storage

Blocking: Runner artifact capture

Configure object storage for logs, screenshots, Playwright traces, coverage reports, and visual diffs. Large artifacts should not live only on runner machines or in Postgres.

object storage configureapi check
openadmin

Create and configure the Telegram bot

Blocking: Telegram tester intake

Create the Smooth Operator Telegram bot, store TELEGRAM_BOT_TOKEN and TELEGRAM_WEBHOOK_SECRET in the approved secret stores, and configure webhook delivery.

telegram bot createsecret presence check
openowner

Configure model provider credentials

Blocking: Real Claude/Codex runner adapters

Configure Anthropic/OpenAI or BYO provider credentials in the worker/runner secret store. Do not expose provider keys to web clients or paste them into chat.

model provider key configuresecret presence check

Dogfood intake

New tester report

Execution pipeline

Runs ready for review

No executions are waiting on human review.

Grooming queue

Reports awaiting team decisions

Human review

Verifier output and merge decisions

No agent runs have been created yet.