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

pd ps

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

Syntax

Run pd ps like this

pd ps
API spec

Command contract

Canonical command

pd find [pattern]

Reference route

/docs/cli/ps

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 ps 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 ps 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 ps resolves to the same command contract.

Examples

Example 01

Run pd ps from a coordinated checkout

CLI
pd ps
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.