Skip to main content
Port Daddy
Sign in
CLI/pd add [path...]
CLI command · v3.30.6

pd add [path...]

Stage files through the claim-aware git add wrapper so another active session does not get captured by accident.

Syntax

Run pd add [path...] like this

pd add README.md
API spec

Command contract

Canonical command

pd add [path...]

Reference route

/docs/cli/add

Reference group

Governance, Scope, Semantics, And Signal Layers

Runtime path

Daemon client with direct-mode fallback where supported

Source

cli/commands/advisor.ts, cli/commands/guard.ts, cli/commands/harbors.ts, cli/commands/wallet.ts, cli/commands/bond.ts, cli/commands/semantic.ts, cli/commands/ideas.ts, cli/commands/roadmap.ts, cli/commands/feedback.ts, cli/commands/pheromone.ts

Aliases

none

Output mode

human display plus --json machine output

Page type

generated API spec from the source-backed catalog

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 add [path...] 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 add [path...] belongs to Governance, Scope, Semantics, And Signal Layers. Coordinate scarce surfaces, protected work areas, budgets, bonds, roadmap memory, and low-friction signals.

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 add [path...]; aliases resolve to the same contract.

Flags

Options that change command behavior

-A

Stage all tracked and untracked paths, filtered through Port Daddy ownership checks.

--all

Include all available rows instead of the default active subset.

--dry-run

Show the operation that would happen without mutating state.

--force

Bypass the normal safety guard for this command.

--json

Return machine-readable JSON instead of the human display.

--dir

Resolve project-scoped behavior from this working directory.

--quiet

Suppress decorative output and print only the essential result.

Examples

Example 01

Run pd add [path...] from a coordinated checkout

CLI
pd add README.md
Output
Prints which paths were staged, skipped, or blocked by active Port Daddy file ownership.
Example 02

Find this command from the full CLI reference

CLI
pd help add
open /docs/cli/add
Output
The help topic and docs route both describe pd add [path...], including aliases, flags, and source provenance.
See also

Nearby command surfaces

pd advise [files...]pd guard <command>pd lock <name>pd unlock <name>pd locks
All commandsSDK reference