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

pd broadcast

pd broadcast is an alias for pd pub <channel> <message>. Publish to a worktree-aware channel.

Syntax

Run pd broadcast like this

pd broadcast
API spec

Command contract

Canonical command

pd pub <channel> <message>

Reference route

/docs/cli/broadcast

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 publish, pd broadcast

Output mode

human display with command-specific state changes

Page type

hand-authored route with catalog-backed fallback

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 broadcast 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 broadcast 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 pub <channel> <message> in automation when you want the canonical spelling; pd broadcast resolves to the same command contract.

Flags

Options that change command behavior

--sender

Stamp the message with an explicit sender id.

--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 broadcast from a coordinated checkout

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