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

pd s

pd s is an alias for pd scan [dir]. Detect frameworks and service entries in a project directory.

Syntax

Run pd s like this

pd s
API spec

Command contract

Canonical command

pd scan [dir]

Reference route

/docs/cli/s

Reference group

Ports, Services, Projects, And Orchestration

Runtime path

daemon-backed CLI command

Source

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

Aliases

pd s

Output mode

human display plus --json machine output

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 s 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 s belongs to Ports, Services, Projects, And Orchestration. Claim deterministic ports, discover services, manage project records, start stacks, and publish readiness.

daemon-backed CLI command. Validate live behavior from the daemon and handler source when changing this command.

Use pd scan [dir] in automation when you want the canonical spelling; pd s resolves to the same command contract.

Flags

Options that change command behavior

--dry-run

Show the operation that would happen without mutating state.

--dir

Resolve project-scoped behavior from this working directory.

--branch

Bind scan or orchestration behavior to a branch name.

--json

Return machine-readable JSON instead of the human display.

Examples

Example 01

Run pd s from a coordinated checkout

CLI
pd s
Output
Runs the pd s command family and prints the resulting Port Daddy state, ids, or readiness/error details.
Example 02

Find this command from the full CLI reference

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