AI developer productivity platform. See CLAUDE.md for project rules and docs/VERSIONS.md for versions.
Prerequisites: Docker, Python 3.12+, Node 22+.
copy .env.example .env
docker compose up -d
# API
cd apps\api
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.lock
pip install -e . --no-deps
alembic upgrade head
uvicorn app.main:app --reload --port 8001
# Web (new terminal)
cd apps\web
copy ..\..\.env.example .env.local # keep only the NEXT_PUBLIC_* lines
npm install
npm run devOpen http://localhost:3001. The page shows API, database and Redis status. Health endpoint: http://localhost:8001/api/v1/health
Sign-in uses Supabase Auth; organizations, teams and roles live in our own Postgres.
Setup steps are in docs/AUTH.md. After pulling new migrations run
alembic upgrade head in apps\api.
Repositories, pull requests, issues, commits and CI runs come from a read-only GitHub App.
Setup, including the webhook tunnel for local testing, is in docs/GITHUB.md.
Gemini through a provider abstraction (Anthropic optional). Needs an API key and model names in
.env; see docs/AI.md. Verify with Test AI connection on an organization page.
GitHub syncs and repository indexing run on a Celery worker (Redis is the queue):
cd apps/api
celery -A app.jobs.celery_app worker --loglevel=info --pool=solo # WindowsNo worker yet? Set JOB_BACKEND=inline to run jobs inside the API. See
docs/INDEXING.md for indexing, limits, exclusions and troubleshooting.
Once a repository is indexed, ask things like "where is authentication implemented?" and get an
answer with citations to exact files and lines. See docs/ASK.md.
Click Review on a pull request for an AI review with findings (file, lines, severity, suggested fix).
Nothing is posted to GitHub. See docs/REVIEWS.md.
Click Analyze on a failed GitHub Actions run for an AI explanation of what broke and why, with
quotes from the logs. Credential-looking lines never reach the model. Nothing is posted to GitHub or
re-run. See docs/CI.md.
What works, what doesn't and the latest test results: docs/IMPLEMENTATION_STATUS.md.
How the code is organized: docs/ARCHITECTURE.md. What changed and when:
docs/DEVELOPMENT_LOG.md.
Web tests: cd apps/web; npm test.
See where AI requests, tokens and errors go, per feature and model, and how close you are to your
provider's daily limit. See docs/USAGE.md.
DevPilot uses non-default host ports so it doesn't clash with other dev tools (WSL port forwarding commonly takes 3000, 5432 and 8000):
| Service | Port |
|---|---|
| Web | 3001 |
| API | 8001 |
| Postgres (Docker) | 5433 |
| Redis (Docker) | 6380 |
cd apps\api; pytest; ruff check .; mypy .; alembic check
cd apps\web; npm run lint; npm run typecheck; npm run build