Documentation

Everything you need to integrate Port Daddy into your development workflow.

Up and running in three commands

Install Port Daddy globally, start the daemon, and claim your first stable port. That is all it takes.

$ npm install -g port-daddy
$ pd start
$ pd claim myapp -q
# => 3001
Read the full Getting Started tutorial

Documentation

Guides, references, and integrations for every part of Port Daddy.

CLI Commands

Every pd command at a glance. All commands support --json and --quiet flags.

Command Description
Port Management
pd claim <id> Claim a stable port for a service
pd release <id> Release a claimed port
pd find [pattern] Find services matching a pattern
pd status Show daemon status and active services
pd health Run health checks on all services
Orchestration
pd up Start all registered services
pd down Stop all running services
pd scan Detect frameworks and register projects
Sessions & Notes
pd session start Start a new coordination session
pd note <text> Add a note to the current session
Locks & Messaging
pd lock <name> Acquire a distributed lock
pd unlock <name> Release a distributed lock
pd pub <channel> Publish a message to a channel
pd sub <channel> Subscribe to a channel (SSE stream)
Tunnels
pd tunnel start <id> Expose a local service via public tunnel
Agents & Salvage
pd agent register Register an agent with heartbeats
pd salvage Check for dead agents to resume
Dashboard
pd dashboard Open the web dashboard in your browser