pd actor <id>
Inspect or message a durable actor mailbox.
Run pd actor <id> like this
pd actor myapp:webCommand contract
pd actor <id>
/docs/cli/actor
Agents, Actors, Fleets, And Spawn Control
daemon-backed CLI command
cli/commands/agents.ts, cli/commands/actors.ts, cli/commands/spawn.ts, cli/commands/fleet.ts, cli/commands/quorum.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 actor <id> reference: daemon health, discovery, and message-loop patterns these pages keep pointing back to.
Common ways this command shows up in practice
pd actor <id> belongs to Agents, Actors, Fleets, And Spawn Control. Launch work, inspect bodies, talk to durable role actors, and run declarative fleets with budget gates.
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 actor <id>; aliases resolve to the same contract.
Options that change command behavior
--project
Resolve or filter the command to a specific project.
--message
Use the provided text as the message body.
--inbox
--inbox is accepted by this command family; see the handler source for command-specific validation and side effects.
--inbox-stats
--inbox-stats is accepted by this command family; see the handler source for command-specific validation and side effects.
--unread
Restrict inbox output to unread messages.
--mark-read
--mark-read is accepted by this command family; see the handler source for command-specific validation and side effects.
--wake
--wake is accepted by this command family; see the handler source for command-specific validation and side effects.
Examples
Run pd actor <id> from a coordinated checkout
pd actor myapp:web
Runs the pd actor <id> command family and prints the resulting Port Daddy state, ids, or readiness/error details.
Find this command from the full CLI reference
pd help actoropen /docs/cli/actor
The help topic and docs route both describe pd actor <id>, including aliases, flags, and source provenance.