A helper skill for AI coding agents to intelligently manage local development ports. Avoid unnecessary restarts and port conflicts by checking port status before starting dev servers.
npx skills add dohoons/port-managerClaude Code:
mkdir -p ~/.claude/skills
cp -r port-manager ~/.claude/skills/GitHub Copilot:
mkdir -p ~/.copilot/skills
cp -r port-manager ~/.copilot/skills/When you ask your AI agent to start a development server, port-manager:
- ✅ Checks if the port is already occupied - No more "port already in use" errors
- ✅ Identifies the running process - Knows if it's the same project or something else
- ✅ Skips unnecessary restarts - If your server is already running, it tells you
- ✅ Offers smart choices - When there's a conflict, asks what you want to do
You: "Start the dev server"
If port 3000 is FREE:
Agent: "✓ Starting dev server at http://localhost:3000"
If port 3000 has YOUR PROJECT:
Agent: "✓ [my-app] dev server is already running at http://localhost:3000"
If port 3000 has ANOTHER PROCESS:
Agent: "⚠️ Port 3000 is occupied by node (PID 1234). Options:
1. Kill it and start my-app server
2. Skip and keep existing
What would you prefer?"
Automatically detects common dev server ports:
- Next.js, Nuxt:
3000 - Vite:
5173 - Create React App:
3000 - Django, Flask:
8000 - Rails:
3000 - Express:
3000(default, varies)
The skill provides clear instructions to your AI agent:
- Identify the project's port from package.json or config files
- Check if port is occupied using
lsof -i :<port> - Handle the situation appropriately:
- Free → Start the server
- Same project → Skip and inform you
- Different process → Ask what to do
Works with:
- ✅ Claude Code
- ✅ GitHub Copilot (VS Code, CLI)
- ✅ Cursor
- ✅ Windsurf
- ✅ Any AI agent that supports the Agent Skills Open Standard
- macOS / Linux: Uses
lsof - Windows (WSL): Uses
lsof - Windows native: Uses
netstat
MIT
dohoons
Built with the Agent Skills Open Standard