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

pd look

Show sitrep-style context, or file heat when used with `--heat`.

Syntax

Run pd look like this

pd look
API spec

Command contract

Canonical command

pd look

Reference route

/docs/cli/look

Reference group

Sessions, Notes, Recovery, And Evidence

Runtime path

daemon-backed CLI command

Source

cli/commands/sugar.ts, cli/commands/sessions.ts, cli/commands/say.ts, cli/commands/look.ts, cli/commands/sitrep.ts, cli/commands/resurrection.ts

Aliases

none

Output mode

human display with command-specific state changes

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 look 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 look belongs to Sessions, Notes, Recovery, And Evidence. Create the audit trail: sessions, file claims, notes, activity, briefing, salvage, and catch-up commands.

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 look; aliases resolve to the same contract.

Examples

Example 01

Run pd look from a coordinated checkout

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