What problem does it solve?
Provides a single, repeatable workflow to set up, run, and diagnose local development environments across multiple projects, reducing onboarding friction and runtime failures caused by misconfigured services, ports, or database access.
Core Features & Use Cases
- Consolidated multi-project manager that auto-discovers per-project .dev-env files and orchestrates start/stop/status across projects.
- Container and native execution patterns with podman-compose guidance, port conventions, and service deduplication for shared resources like MariaDB.
- Database and migration guidance covering EF Core migrations, MariaDB socket vs TCP access, and common fixes for connection/auth errors.
- Lightweight monitoring and alerting patterns (cron monitor for macOS notifications) and practical troubleshooting steps for common runtime issues.
Quick Start
Start the consolidated local development stack by running dev-ctl status to inspect services and then dev-ctl start <project-id> to bring up a specific project's environment.