Monorepo for Iterate's Cloudflare Workers platform. apps/os is the main app — the product dashboard at os.iterate.com.

• Commands run in the context of a Doppler config; that config chooses secrets, app config, Cloudflare account, and Alchemy stage.
• Local dev, previews, and production use the same alchemy.run.ts primitive with different configs: dev_<you>, preview_N, or prd.
• Details: DevOps: Cloudflare, Doppler, And Alchemy.

Run these from apps/os. Wrap in doppler run --project os --config <config> -- … to target a specific environment; the config supplies URLs and secrets.

OS exposes oRPC at /api/orpc/. The app CLI discovers procedures remotely and authenticates with the config's shared API secret:

# production (default when no DOPPLER_CONFIG is set)
pnpm cli rpc --help

# preview slot 2
doppler run --project os --config preview_2 -- \
  sh -c 'OS_BASE_URL="$APP_CONFIG_BASE_URL" pnpm cli rpc --help'

# local dev server (while pnpm dev is running)
doppler run --project os --config dev_jonas -- \
  pnpm cli rpc --base-url http://localhost:5183 --help

Replace --help with a procedure path to call it.

Open Claude Code against a deployed project's MCP server:

doppler run --project os --config prd -- \
  pnpm cli claude-mcp --project-slug-or-id my-project

The Doppler config picks the environment (prod, preview, your dev tunnel). APP_CONFIG_PROJECT_HOSTNAME_BASES in the config sets the project hostname base (e.g. iterate.app, iterate-preview-3.app); override with --base-host if needed.

More: apps/os README.

pnpm install
pnpm dev          # local OS dev server

Before PRs:

pnpm install && pnpm typecheck && pnpm lint && pnpm format && pnpm test

Start here: apps/os/

Other Cloudflare apps (events, semaphore, example, …) are supporting services — see docs/architecture.md.

pnpm dev                      # local OS dev server
pnpm mcp:dev                  # local MCP app against local auth
pnpm --dir apps/auth dev      # auth app only
pnpm os dev                   # same, explicit apps/os path
pnpm test && pnpm typecheck && pnpm lint && pnpm format

Dev server, Doppler, Cloudflare, previews, and deploys: docs/devops-cloudflare-doppler-alchemy-setup.md.

• Architecture
• DevOps: Cloudflare, Doppler, And Alchemy
• Brand & tone

• Coding style
• TypeScript conventions
• Design system & React
• Vitest patterns

• DevOps: Cloudflare, Doppler, And Alchemy
• Drizzle migrations — not for apps/os (sqlfu/D1)
• Fixing Drizzle migration conflicts

• Task system
• Task grooming
• Writing agent docs

• OS app
• OS architecture & operations