pd listen
pd listen is an alias for pd sub <channel>. Subscribe to a channel as an SSE stream.
Run pd listen like this
pd listenCommand contract
pd sub <channel>
/docs/cli/listen
Messaging, Tube, Inbox, Tuples, Webhooks, And Tunnels
daemon-backed CLI command
cli/commands/messaging.ts, cli/commands/tube.ts, cli/commands/inbox.ts, cli/commands/tuples.ts, cli/commands/webhooks.ts, cli/commands/tunnel.ts
pd subscribe, pd listen
human display with command-specific state changes
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 listen reference: daemon health, discovery, and message-loop patterns these pages keep pointing back to.
Common ways this command shows up in practice
pd listen 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 listen resolves to the same command contract.
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
Run pd listen from a coordinated checkout
pd listen
Runs the pd listen command family and prints the resulting Port Daddy state, ids, or readiness/error details.
Find this command from the full CLI reference
pd help subopen /docs/cli/sub
The help topic and docs route both describe pd sub <channel>, including aliases, flags, and source provenance.