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:
pnpm dev
The .replit onBoot command installs dependencies with:
pnpm install --ignore-workspace
Install
Run from this repository root:
pnpm install --ignore-workspace
Use the available pnpm. This repo intentionally has no packageManager pin.
Start
pnpm dev
When Replit AI Integrations are provisioned, the app reads these variables automatically:
AI_INTEGRATIONS_OPENAI_BASE_URLAI_INTEGRATIONS_OPENAI_API_KEYAI_INTEGRATIONS_ANTHROPIC_BASE_URLAI_INTEGRATIONS_ANTHROPIC_API_KEY
Provider CLI flags are still supported for manual overrides:
pnpm dev -- \
--openai-base-url "<ai-integrations-openai-base-url>" \
--openai-api-key "<ai-integrations-openai-api-key>" \
--anthropic-base-url "<ai-integrations-anthropic-base-url>" \
--anthropic-api-key "<ai-integrations-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:
--hostorHOST--portorPORT--proxy-api-keyorPROXY_API_KEY
Verify
curl -s http://localhost:3000/api/healthz
curl -s http://localhost:3000/dashboard | head
curl -s -H "Authorization: Bearer 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.