managing-ports
CommunityAutomatically manage dev ports and avoid conflicts
System Documentation
What problem does it solve?
Detects framework, finds available ports, and starts dev servers with correct port flags. Resolves port conflicts when multiple projects compete for the same default port (common with git worktrees). Scans running processes, identifies frameworks from config files, and uses the right CLI flag per framework. Use when starting dev server, port conflict, port in use, address already in use, EADDRINUSE, npm run dev, pnpm dev, yarn dev, listen EADDRINUSE, port 3000 taken, or managing multiple local servers.
Core Features & Use Cases
- Detects framework from project config files (e.g., next.config., nuxt.config., vite.config.*) and selects the correct dev server flag.
- Finds the first available port starting from the framework default or a provided override, and gracefully handles port conflicts.
- Provides safe operations by scanning running processes and listing the steps needed to start multiple local servers without collisions.
Quick Start
Run the port management workflow to detect your framework, find a free port, and start the dev server.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: managing-ports Download link: https://github.com/Saturate/skills/archive/main.zip#managing-ports Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.