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

pd c

pd c is an alias for pd claim <id>. Claim a deterministic service port by semantic identity.

Syntax

Run pd c like this

pd c
API spec

Command contract

Canonical command

pd claim <id>

Reference route

/docs/cli/c

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 c

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 c 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 c 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 claim <id> in automation when you want the canonical spelling; pd c resolves to the same command contract.

Flags

Options that change command behavior

--port

Request or target a specific daemon or service port.

--range

Restrict port selection to the provided numeric range.

--expires

Set an expiration for the claim or coordination record.

--export

Print shell export output for successful claims.

--json

Return machine-readable JSON instead of the human display.

--quiet

Suppress decorative output and print only the essential result.

Examples

Example 01

Run pd c from a coordinated checkout

CLI
pd c
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 claim
open /docs/cli/claim
Output
The help topic and docs route both describe pd claim <id>, including aliases, flags, and source provenance.