Skip to main content
Port Daddy
Sign in
CLI/pd compass
CLI command · v3.30.6

pd compass

pd compass is an alias for pd advise [files...]. Run deterministic coordination preflight before edits.

Syntax

Run pd compass like this

pd compass
API spec

Command contract

Canonical command

pd advise [files...]

Reference route

/docs/cli/compass

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 compass 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 compass 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 pd advise [files...] in automation when you want the canonical spelling; pd compass resolves to the same command 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 compass from a coordinated checkout

CLI
pd compass
Output
Runs the pd compass 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