Is Portman useful for CI/CD environments?

Yes, its context-aware nature allows parallel CI jobs on the same runner to operate independently without interfering with each other's network requirements.

How do I clean up ports from deleted worktrees?

You can use the 'portman prune' command to identify and remove port allocations for directories that no longer exist on your machine.

Does it support shell automation tools like direnv?

Absolutely. You can add the export command to your .envrc file to automatically load and set the correct ports as soon as you enter a project directory.

Can I use Portman with Docker Compose?

Yes, Portman is designed to work with Docker Compose by using environment variables in your YAML files which are then dynamically populated with allocated ports.

How does Portman prevent port conflicts?

Portman creates a unique context based on your current directory and git remote, assigning distinct port numbers to services within that specific worktree to ensure isolation.

Portman Port Management

Name: Portman Port Management
Author: jpoutrin

byjpoutrin

•

Deployment & DevOps

Automates local port allocation for git worktrees and docker-compose to prevent service collisions during parallel development.

Portman is a context-aware port management skill designed for developers working with multiple git worktrees or parallel project instances. It eliminates the friction of manual port tracking by dynamically booking and exporting unique ports for services like PostgreSQL, Redis, and web servers based on the specific directory and git branch context. By integrating seamlessly with shell environments, direnv, and Docker Compose, Portman ensures that every local development environment remains isolated and functional without the risk of 'port already in use' errors.

Key Features

01Context-aware port booking based on git worktree and branch context

02Dynamic environment variable export for shell and direnv integration

03Maintenance tools for pruning orphaned allocations from deleted worktrees

04Automatic service discovery and port reservation from docker-compose.yml

05Configurable port ranges per service to meet specific project requirements

062 GitHub stars

Use Cases

01Automating local infrastructure configuration using dynamic environment variables in Docker

02Running multiple feature branches simultaneously using git worktrees without port collisions

03Creating standardized, one-click development environment setup scripts for engineering teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jpoutrin/product-forge portman

For use in Claude.ai and ChatGPT

Download Skill