Portman Skill

This skill provides patterns for managing port allocations in local development environments using portman. It enables running multiple worktrees of the same project in parallel without port conflicts.

Why Portman?

When working with git worktrees or multiple project instances:

• Each worktree needs unique ports for services (postgres, redis, web server, etc.)
• Manual port management is error-prone and tedious
• Docker-compose files hardcode ports causing conflicts

Portman automatically assigns unique ports per worktree context.

Core Workflow

1. Initial Setup (Once per machine)

# Initialize portman and show shell integration