local-dev

Orchestrate multi-project local dev environments with dev-ctl and podman-compose.

7|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/rloisell/rl-agents-n-skills --skill local-dev-rloisell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-dev
Source: https://github.com/rloisell/rl-agents-n-skills/tree/main/local-dev
Command: npx skills add https://github.com/rloisell/rl-agents-n-skills --skill local-dev-rloisell

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about local-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a local development environment with multiple projects and shared MariaDB instances?

To set up a local development environment, use a consolidated multi-project manager that auto-discovers `.dev-env` files and orchestrates services with deduplication for shared MariaDB resources. This ensures consistent port conventions and reduces onboarding friction across multi-repository projects.

How does podman-compose orchestrate containers for multi-repository local development?

Podman-compose orchestrates containers for local development by applying container execution patterns, defining port conventions, and deduplicating shared services like MariaDB. The manager coordinates start and stop actions across multiple repositories using auto-discovered `.dev-env` files.

Why does EF Core migration fail to connect to MariaDB using TCP instead of socket?

EF Core migration fails when MariaDB connection strings mismatch socket versus TCP access protocols. Apply database connection guidance to resolve common authentication and endpoint errors, ensuring your local development environment uses the correct access method.

Can I use dev-ctl to monitor and troubleshoot local development stacks on macOS?

Yes, you can use dev-ctl to monitor local development stacks on macOS. It provides lightweight cron-based monitoring alerts and practical troubleshooting steps to diagnose runtime failures, misconfigured services, or port conflicts across your projects.

What is the best way to manage multi-project local dev stacks without port conflicts?

The best way to manage multi-project local dev stacks is using a consolidated manager that enforces consistent port conventions and service deduplication. This prevents port conflicts and database access issues by standardizing orchestration across all repositories.