Port Allocator FAQs

Question 1

Where is the port configuration stored?

Accepted Answer

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

Question 2

How does the Port Allocator decide which ports to use?

Accepted Answer

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.

Question 3

Will this skill kill my other running processes?

Accepted Answer

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.

Question 4

Do I need to manually add every project?

Accepted Answer

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.

Question 5

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

Accepted Answer

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

Port Allocator

Key Features

Use Cases

Port Allocator

Key Features

Use Cases