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

生産性とワークフロー

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.

主な機能

Dedicated 10-port range allocation for apps, APIs, and services
Centralized port registry for monitoring local resource usage
Automated permission configuration for Claude Code settings
0 GitHub stars
Automatic project discovery via package.json scanning
Safe process management to prevent cross-project service interruption

ユースケース

Preventing port collisions when switching between different Claude Code coding sessions
Running multiple microservices simultaneously without manual port configuration
Orchestrating local dev environments for developers with dozens of project folders

概要

主な機能

Dedicated 10-port range allocation for apps, APIs, and services
Centralized port registry for monitoring local resource usage
Automated permission configuration for Claude Code settings
0 GitHub stars
Automatic project discovery via package.json scanning
Safe process management to prevent cross-project service interruption

ユースケース

Preventing port collisions when switching between different Claude Code coding sessions
Running multiple microservices simultaneously without manual port configuration
Orchestrating local dev environments for developers with dozens of project folders