How does the Port Allocator prevent conflicts?

It assigns a unique 10-port block to every project it discovers, ensuring that each application and its associated services (like APIs or databases) have a reserved, non-overlapping port range.

Does it work with non-JavaScript projects?

The current version specifically targets web development workflows by scanning for the presence of a package.json file to identify active project directories.

Can I customize the directory it scans?

Yes, you can use the '/port-allocator config ' command to set your primary development folder, or manually add projects using the add command.

Will this kill my other running servers?

No. One of the core rules of this skill is to only target processes within the specific project's allocated port range, preventing the 'killall node' commands that often disrupt other work.

Smart Port Allocator

Name: Smart Port Allocator
Author: susuyan

bysusuyan

0•

生产力与工作流

Automatically manages development server ports to prevent conflicts between multiple projects and Claude Code instances.

The Port Allocator skill streamlines local development by managing port assignments across your projects. It automatically scans your code directories for projects containing a package.json and reserves a dedicated 10-port block for each (e.g., 3000-3009). This organization prevents 'port already in use' errors and ensures that when Claude restarts a service, it only kills processes within the specific project's range, protecting your other active development environments from accidental disruption.

主要功能

01Dedicated 10-port range allocation for apps, APIs, and services

02Centralized port registry for monitoring local resource usage

03Automated permission configuration for Claude Code settings

040 GitHub stars

05Automatic project discovery via package.json scanning

06Safe process management to prevent cross-project service interruption

使用场景

01Preventing port collisions when switching between different Claude Code coding sessions

02Running multiple microservices simultaneously without manual port configuration

03Orchestrating local dev environments for developers with dozens of project folders

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add susuyan/skills port-allocator

For use in Claude.ai and ChatGPT