portman

What problem does it solve?

Running multiple local development instances or git worktrees of the same project often leads to port conflicts, making parallel development tedious and error-prone. This Skill provides patterns for managing port allocations with portman.

Core Features & Use Cases

• Core Workflow: Setup, booking, getting, and exporting ports for services.
• Integration with Docker Compose: Configure docker-compose.yml to use dynamic ports via environment variables.
• Direnv Integration: Automatically set port environment variables when entering a project directory.
• Context-Aware Port Allocation: portman automatically assigns unique ports per worktree context, ensuring isolation.
• Maintenance Commands: Tools for viewing allocations, pruning orphaned entries, and troubleshooting.
• Use Case: Setting up a new git worktree for a feature branch, configuring docker-compose.yml to use dynamic ports, cleaning up orphaned port allocations, or ensuring unique ports for parallel CI jobs.

Quick Start

Use the portman skill to generate a docker-compose.yml snippet that uses environment variables for PostgreSQL and Redis ports.