pd b
pd b is an alias for pd begin "purpose". Register an agent, start a session, and write local context in one command.
Run pd b like this
pd bCommand contract
pd begin "purpose"
/docs/cli/b
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
pd b
human display with command-specific state changes
hand-authored route with catalog-backed fallback
This clip shows the daemon health check, command discovery, and message-loop patterns that recur across the CLI reference. Here it grounds the pd b reference: daemon health, discovery, and message-loop patterns these pages keep pointing back to.
Common ways this command shows up in practice
pd b 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 begin "purpose" in automation when you want the canonical spelling; pd b resolves to the same command contract.
Options that change command behavior
--lifecycle
--lifecycle is accepted by this command family; see the handler source for command-specific validation and side effects.
--identity
Use this semantic identity for an agent, session, service, or launch.
--agent
Target or stamp a specific agent id.
--type
Stamp the session or note with a typed category.
--files
Attach file paths to the session or launch request.
Examples
Run pd b from a coordinated checkout
pd b
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 beginopen /docs/cli/begin
The help topic and docs route both describe pd begin "purpose", including aliases, flags, and source provenance.