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

pd publish

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

Syntax

Run pd publish like this

pd publish
API spec

Command contract

Canonical command

pd pub <channel> <message>

Reference route

/docs/cli/publish

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

CLI
pd publish
Output
Runs the pd publish 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.