Documentation
README
Run Services
Start all local development services with pre-flight dependency checks and automatic error recovery.
Overview
This command automates the full startup workflow: 0. Smart port selection โ auto-detects free port group or reuses current worktree's ports
- Pre-flight dependency checks (uv sync, venv, npm, worktree editable packages)
- Stops any existing services (only if needed)
- Starts all services via
run_services.sh - Health-checks each service
- Diagnoses and fixes failures, then retries (up to 2 retries)
Port Configuration
Ports are allocated in groups of 3 with a +10 offset between groups:
This is the opening of the README. Read the full README on GitHub.