1.5 KiB
Agent Runbook
Run this repository as a standalone app. Do not add it to a parent workspace. Do not move it into artifacts/. Do not edit source files for setup.
Use port 18080; do not use or free port 8080.
Setup
Run from this repository root:
pnpm install --ignore-workspace
pnpm dev
If plain pnpm is unavailable, use corepack pnpm for the same commands. Do not edit package.json.
The app runs without config.json:
- host:
0.0.0.0 - port:
18080 - bearer token:
dev-proxy-key
Optional Provider Config
Do not create config.json unless internal provider endpoints/tokens are available.
If they are available, create config.json in one write with this shape:
{
"server": {
"host": "0.0.0.0",
"port": 18080
},
"proxy": {
"apiKey": "dev-proxy-key"
},
"providers": {
"openai": {
"apiKey": "",
"baseURL": ""
},
"anthropic": {
"apiKey": "",
"baseURL": ""
}
},
"logging": {
"level": "info",
"pretty": true
}
}
Fill only providers.openai.apiKey, providers.openai.baseURL, providers.anthropic.apiKey, and providers.anthropic.baseURL. Use internal endpoints only. Never use public official provider endpoints.
Verify
curl -s http://localhost:18080/api/healthz
curl -s http://localhost:18080/dashboard | head
curl -s -H "Authorization: Bearer dev-proxy-key" http://localhost:18080/v1/models
Expected without provider config: dashboard, health, and model list work; chat completions return 503.