Skip to main content
CLI/pd list
CLI command · v3.30.6

pd list

pd list is an alias for pd find [pattern]. List matching claimed services and their ports.

Syntax

Run pd list like this

pd list
API spec

Command contract

Canonical command

pd find [pattern]

Reference route

/docs/cli/list

Reference group

Ports, Services, Projects, And Orchestration

Runtime path

Daemon client with direct-mode fallback where supported

Source

cli/commands/services.ts, cli/commands/projects.ts, cli/commands/orchestration.ts, cli/commands/integration.ts, cli/commands/dns.ts

Aliases

pd f, pd l, pd list, pd ps, pd services

Output mode

human display with command-specific state changes

Page type

hand-authored route with catalog-backed fallback

See the command surfaces this reference keeps in play

This clip shows the daemon health check, command discovery, and message-loop patterns that recur across the CLI reference. Here it grounds the pd list reference: daemon health, discovery, and message-loop patterns these pages keep pointing back to.

Usage patterns

Common ways this command shows up in practice

pd list 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 pd find [pattern] in automation when you want the canonical spelling; pd list resolves to the same command contract.

Examples

Example 01

Run pd list from a coordinated checkout

CLI
pd list
Output
Prints the changed record or lookup result; use --json when you need the exact machine-readable shape.
Example 02

Find this command from the full CLI reference

CLI
pd help find
open /docs/cli/find
Output
The help topic and docs route both describe pd find [pattern], including aliases, flags, and source provenance.