managing-ports

Detect frameworks, find available ports, and start dev servers with correct flags.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/Saturate/skills --skill managing-ports
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: managing-ports
Source: https://github.com/Saturate/skills/tree/main/managing-ports
Command: npx skills add https://github.com/Saturate/skills --skill managing-ports

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about managing-ports

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix the EADDRINUSE error when running my dev server?

To resolve an EADDRINUSE port conflict, this Skill scans running processes, finds the first available port from the framework default, and restarts the dev server using the correct CLI flag.

How do I automatically find an available port for Next.js or Vite?

It automatically finds an available port for Next.js or Vite by detecting the framework from project config files, scanning for open ports, and applying the correct port flag to the dev server startup command.

What is the best way to manage multiple local dev servers without port collisions?

The best way to manage multiple local dev servers without port collisions is to scan running processes, identify the web framework from its config, and assign the first available port using framework-specific CLI flags.

Does this port management workflow support Django, Flask, and Rails?

Yes, this port management workflow supports Django, Flask, and Rails. It detects the framework from project configuration files and uses the appropriate port flag to start the dev server safely.

How do I prevent port 3000 from being taken when using git worktrees?

To prevent port 3000 from being taken across git worktrees, the Skill scans running processes to locate the next free port and starts the development server with the correct framework-specific port flag.

What happens if the framework cannot be detected from config files?

If the framework cannot be detected from config files, the Skill implements safe error handling and provides clear user guidance to ensure you can still resolve the port conflict and start your dev server.