pd ports
List active or system port assignments, and clean up stale claims.
Run pd ports like this
pd portsCommand contract
pd ports
/docs/cli/ports
Ports, Services, Projects, And Orchestration
Daemon client with direct-mode fallback where supported
cli/commands/services.ts, cli/commands/projects.ts, cli/commands/orchestration.ts, cli/commands/integration.ts, cli/commands/dns.ts
none
human display with command-specific state changes
generated API spec from the source-backed catalog
This clip shows the daemon health check, command discovery, and message-loop patterns that recur across the CLI reference. Here it grounds the pd ports reference: daemon health, discovery, and message-loop patterns these pages keep pointing back to.
Common ways this command shows up in practice
pd ports belongs to Ports, Services, Projects, And Orchestration. Claim deterministic ports, discover services, manage project records, start stacks, and publish readiness.
Daemon client with direct-mode fallback where supported. Validate live behavior from the daemon and handler source when changing this command.
Use this page as the stable public contract for pd ports; aliases resolve to the same contract.
Options that change command behavior
--system
--system is accepted by this command family; see the handler source for command-specific validation and side effects.
cleanup
Remove stale port records.
Examples
Run pd ports from a coordinated checkout
pd ports
Prints the changed record or lookup result; use --json when you need the exact machine-readable shape.
Find this command from the full CLI reference
pd help portsopen /docs/cli/ports
The help topic and docs route both describe pd ports, including aliases, flags, and source provenance.