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

•

Despliegue y DevOps

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

Acerca de

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.

Características Principales

Context-aware port booking based on git worktree and branch context
Dynamic environment variable export for shell and direnv integration
Maintenance tools for pruning orphaned allocations from deleted worktrees
Automatic service discovery and port reservation from docker-compose.yml
Configurable port ranges per service to meet specific project requirements
2 GitHub stars

Casos de Uso

Automating local infrastructure configuration using dynamic environment variables in Docker
Running multiple feature branches simultaneously using git worktrees without port collisions
Creating standardized, one-click development environment setup scripts for engineering teams

Acerca de

Características Principales

Context-aware port booking based on git worktree and branch context
Dynamic environment variable export for shell and direnv integration
Maintenance tools for pruning orphaned allocations from deleted worktrees
Automatic service discovery and port reservation from docker-compose.yml
Configurable port ranges per service to meet specific project requirements
2 GitHub stars

Casos de Uso

Automating local infrastructure configuration using dynamic environment variables in Docker
Running multiple feature branches simultaneously using git worktrees without port collisions
Creating standardized, one-click development environment setup scripts for engineering teams