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

pd subscribe

pd subscribe is an alias for pd sub <channel>. Subscribe to a channel as an SSE stream.

Syntax

Run pd subscribe like this

pd subscribe
API spec

Command contract

Canonical command

pd sub <channel>

Reference route

/docs/cli/subscribe

Reference group

Messaging, Tube, Inbox, Tuples, Webhooks, And Tunnels

Runtime path

daemon-backed CLI command

Source

cli/commands/messaging.ts, cli/commands/tube.ts, cli/commands/inbox.ts, cli/commands/tuples.ts, cli/commands/webhooks.ts, cli/commands/tunnel.ts

Aliases

pd subscribe, pd listen

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 subscribe 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 subscribe belongs to Messaging, Tube, Inbox, Tuples, Webhooks, And Tunnels. Move events between agents, local tools, editors, browsers, hooks, and external adapters.

daemon-backed CLI command. Validate live behavior from the daemon and handler source when changing this command.

Use pd sub <channel> in automation when you want the canonical spelling; pd subscribe resolves to the same command contract.

Flags

Options that change command behavior

--dir

Resolve project-scoped behavior from this working directory.

--raw-channel

Use the channel string literally instead of project scoping it.

Examples

Example 01

Run pd subscribe from a coordinated checkout

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