Where is the port configuration stored?

All allocations and settings are stored locally on your machine in ~/.claude/port-registry.json, making the data persistent across sessions.

How does the Port Allocator decide which ports to use?

It starts at port 3000 and assigns 10 consecutive ports (e.g., 3000-3009) to each project it discovers. This allows for a main app, an API, and several background services per project.

Will this skill kill my other running processes?

No, it is specifically programmed to only kill processes within the current project's allocated port range. It avoids generic commands like 'pkill node' to ensure other projects remain unaffected.

Do I need to manually add every project?

No, you can use the /port-allocator scan command to automatically detect all projects within your main code directory that contain a package.json file.

What if my project doesn't have a package.json?

You can manually register any directory using the /port-allocator add command to ensure it receives a dedicated port range.

Port Allocator

Name: Port Allocator
Author: guo-yu

byguo-yu

•

201

생산성 및 워크플로

Automates development server port assignment and management to prevent conflicts across multiple Claude Code projects.

소개

Port Allocator is a specialized utility for developers running multiple Claude Code instances who want to eliminate the frustration of port conflicts. It intelligently scans your workspace to identify projects containing a package.json file and assigns each a dedicated range of 10 consecutive ports. By maintaining a centralized registry and enforcing strict rules about process termination, it ensures that restarting a server in one project never accidentally interrupts services in another, providing a stable and predictable local development environment.

주요 기능

Automated permission configuration for Claude Code
Automated port range allocation (10 ports per project)
201 GitHub stars
Intelligent project discovery via package.json detection
Conflict prevention through isolated process management
Centralized port registry in ~/.claude/port-registry.json

사용 사례

Preventing accidental process kills when restarting development servers
Managing multiple microservices or monorepo packages simultaneously
Standardizing port assignments across complex local development environments

소개

주요 기능

Automated permission configuration for Claude Code
Automated port range allocation (10 ports per project)
201 GitHub stars
Intelligent project discovery via package.json detection
Conflict prevention through isolated process management
Centralized port registry in ~/.claude/port-registry.json

사용 사례

Preventing accidental process kills when restarting development servers
Managing multiple microservices or monorepo packages simultaneously
Standardizing port assignments across complex local development environments