Manages per-worktree port allocations for git worktrees and docker-compose services.
npx skills add https://github.com/jpoutrin/product-forge --skill portman
Please help me install this Agent Skill. Skill: portman Source: https://github.com/jpoutrin/product-forge/tree/main/plugins/devops-data/skills/portman Command: npx skills add https://github.com/jpoutrin/product-forge --skill portman
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.
docker-compose.yml to use dynamic ports via environment variables.portman automatically assigns unique ports per worktree context, ensuring isolation.docker-compose.yml to use dynamic ports, cleaning up orphaned port allocations, or ensuring unique ports for parallel CI jobs.Use the portman skill to generate a docker-compose.yml snippet that uses environment variables for PostgreSQL and Redis ports.
High-intent search queries and answers about installing and using this skill.
Port conflicts arise when parallel worktrees run the same services on identical ports. Portman resolves this by automatically assigning unique ports per worktree context, isolating each environment so services like PostgreSQL and Redis run without collisions across branches.
Portman discovers services in docker-compose.yml, books unique ports per worktree, and exports environment variables for each service. Configure your compose file to reference these variables—portman handles port allocation and environment setup automatically.
Yes. Portman integrates with direnv to automatically export port environment variables when you enter a project directory. This eliminates manual port configuration and ensures the correct ports load for each worktree context without extra steps.
Portman requires git worktrees and docker-compose configured in your project. No external dependencies are needed—portman auto-discovers your services from docker-compose.yml and manages port allocation via context-aware workflows and environment export.
Portman includes maintenance commands to view current allocations, prune orphaned entries from deleted worktrees, and verify port status. Use these tools to troubleshoot conflicts and keep your port registry clean as worktrees are created and removed.
Yes. Portman's context-aware port allocation assigns unique ports per job context, making it suitable for CI pipelines that run multiple parallel instances. Each job receives isolated ports, eliminating conflicts in containerized or distributed testing environments.
elasticdotventuresAutomate loading of per-project environment variables via direnv and dotenv with Rust validation.
EZotoffokay, here's a shorter one:
jpoutrinManages per-worktree port allocations for git worktrees and docker-compose services.
Fantasia1999Manage Git worktrees with deterministic port allocation and safe cleanup.