pd channels
List, discover, ensure, describe, or clear channels.
Run pd channels like this
pd channelsCommand contract
pd channels
/docs/cli/channels
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
none
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 channels reference: daemon health, discovery, and message-loop patterns these pages keep pointing back to.
Common ways this command shows up in practice
pd channels 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 this page as the stable public contract for pd channels; aliases resolve to the same contract.
Options that change command behavior
discover
Discover declared and observed channels.
ensure
Create or update the channel declaration.
describe
Print a single channel, signal, or resource description.
clear
Delete matching channel state.
--dir
Resolve project-scoped behavior from this working directory.
--observed
Include observed channel traffic in discovery output.
--scope
Limit channel discovery to the requested scope.
--aliases
--aliases is accepted by this command family; see the handler source for command-specific validation and side effects.
Examples
Run pd channels from a coordinated checkout
pd channels
Runs the pd channels command family and prints the resulting Port Daddy state, ids, or readiness/error details.
Find this command from the full CLI reference
pd help channelsopen /docs/cli/channels
The help topic and docs route both describe pd channels, including aliases, flags, and source provenance.