| name | dev-servers |
| description | Start the backend (FastAPI/uvicorn) and frontend (Vite) development servers. Use when user mentions "start dev", "run servers", "launch app", "start the app", or needs to run the application locally. |
| allowed-tools | Bash |
Development Servers
Instructions
Check if dependencies are installed:
- Backend: Look for
backend/venv/or ask user about Python environment - Frontend: Check if
frontend/node_modules/exists
- Backend: Look for
Install dependencies if missing:
- Backend:
cd backend && pip install -r requirements.txt - Frontend:
cd frontend && npm install
- Backend:
Start servers (recommend running in separate terminals or background):
- Backend:
cd backend && uvicorn main:app --reload(runs on http://localhost:8000) - Frontend:
cd frontend && npm run dev(runs on http://localhost:5173)
- Backend:
Verify
.envfile exists inbackend/withOPENAI_API_KEYset
Examples
- "Start the dev servers"
- "Run the app locally"
- "Launch backend and frontend"
Guardrails
- Never expose or log the OPENAI_API_KEY
- Confirm with user before installing dependencies
- Warn if ports 8000 or 5173 are already in use