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

pd advise [files...]

Run deterministic coordination preflight before edits.

Syntax

Run pd advise [files...] like this

pd advise src/app.ts
API spec

Command contract

Canonical command

pd advise [files...]

Reference route

/docs/cli/advise

Reference group

Governance, Scope, Semantics, And Signal Layers

Runtime path

daemon-backed CLI command

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

pd preflight, pd compass

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

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

Use this page as the stable public contract for pd advise [files...]; aliases resolve to the same contract.

Flags

Options that change command behavior

--task

Describe the intended edit or action for advisor output.

--session

Target a specific session id.

--agent

Target or stamp a specific agent id.

--dir

Resolve project-scoped behavior from this working directory.

--channels

Include channel discovery and subscription context in advisory output.

--tuples

Include tuple-space context in advisory output.

--json

Return machine-readable JSON instead of the human display.

Examples

Example 01

Run pd advise [files...] from a coordinated checkout

CLI
pd advise src/app.ts
Output
Runs the pd advise [files...] 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 advise
open /docs/cli/advise
Output
The help topic and docs route both describe pd advise [files...], including aliases, flags, and source provenance.
See also

Nearby command surfaces

pd guard <command>pd add [path...]pd lock <name>pd unlock <name>pd locks
All commandsSDK reference