pd sessions
List active or historical sessions.
Run pd sessions like this
pd sessionsCommand contract
pd sessions
/docs/cli/sessions
Sessions, Notes, Recovery, And Evidence
Daemon client with direct-mode fallback where supported
cli/commands/sugar.ts, cli/commands/sessions.ts, cli/commands/say.ts, cli/commands/look.ts, cli/commands/sitrep.ts, cli/commands/resurrection.ts
none
human display plus --json machine output
generated API spec from the source-backed catalog
This clip shows the daemon health check, command discovery, and message-loop patterns that recur across the CLI reference. Here it grounds the pd sessions reference: daemon health, discovery, and message-loop patterns these pages keep pointing back to.
Common ways this command shows up in practice
pd sessions 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 this page as the stable public contract for pd sessions; aliases resolve to the same contract.
Options that change command behavior
--all
Include all available rows instead of the default active subset.
--status
Filter rows by lifecycle status.
--all-worktrees
Include active sessions from every known worktree.
--json
Return machine-readable JSON instead of the human display.
Examples
Run pd sessions from a coordinated checkout
pd sessions
Prints the changed record or lookup result; use --json when you need the exact machine-readable shape.
Find this command from the full CLI reference
pd help sessionsopen /docs/cli/sessions
The help topic and docs route both describe pd sessions, including aliases, flags, and source provenance.