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

pd n

pd n is an alias for pd note <content>. Append an immutable note to the active or targeted session.

Syntax

Run pd n like this

pd n
API spec

Command contract

Canonical command

pd note <content>

Reference route

/docs/cli/n

Reference group

Sessions, Notes, Recovery, And Evidence

Runtime path

Daemon client with direct-mode fallback where supported

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

pd n

Output mode

human display with command-specific state changes

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

Daemon client with direct-mode fallback where supported. Validate live behavior from the daemon and handler source when changing this command.

Use pd note <content> in automation when you want the canonical spelling; pd n resolves to the same command contract.

Flags

Options that change command behavior

--type

Stamp the session or note with a typed category.

--session

Target a specific session id.

--agent

Target or stamp a specific agent id.

Examples

Example 01

Run pd n from a coordinated checkout

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