# Agent Runbook This app is already prepared for one-shot deployment. Follow these commands exactly unless one fails. Do not add this repo to a parent workspace. Do not move it into `artifacts/`. Do not edit source files. Do not edit `package.json`. Do not create `config.json` or a `/tmp` config file for deployment. Do not inspect or free unrelated ports. ## Replit The repo includes `.replit`, so after import the Run button starts the app with: ```bash pnpm dev ``` The `.replit` `onBoot` command installs dependencies with: ```bash pnpm install --ignore-workspace ``` ## Install Run from this repository root: ```bash pnpm install --ignore-workspace ``` Use the available `pnpm`. This repo intentionally has no `packageManager` pin. ## Start ```bash pnpm dev ``` When Replit AI Integrations are provisioned, the app reads these variables automatically: - `AI_INTEGRATIONS_OPENAI_BASE_URL` - `AI_INTEGRATIONS_OPENAI_API_KEY` - `AI_INTEGRATIONS_ANTHROPIC_BASE_URL` - `AI_INTEGRATIONS_ANTHROPIC_API_KEY` Provider CLI flags are still supported for manual overrides: ```bash pnpm dev -- \ --openai-base-url "" \ --openai-api-key "" \ --anthropic-base-url "" \ --anthropic-api-key "" ``` Use Replit AI Integrations endpoints only. Never use public official provider endpoints. Do not print provider tokens. ## Defaults - host: `0.0.0.0` - port: `3000` - bearer token: `dev-proxy-key` These can be overridden with CLI flags or environment variables: - `--host` or `HOST` - `--port` or `PORT` - `--proxy-api-key` or `PROXY_API_KEY` For mass deployments, pass the generated token with `--proxy-api-key`. The app will use that token as the required `Authorization: Bearer ...` value. ## Verify ```bash curl -s http://localhost:3000/api/healthz curl -s http://localhost:3000/dashboard | head curl -s -H "Authorization: Bearer ${PROXY_API_KEY:-dev-proxy-key}" http://localhost:3000/v1/models ``` Expected without provider flags: dashboard, health, and model list work; chat completions return `503`. Report only the local URL and verification results.