pd agents
List registered agents.
Run pd agents like this
pd agentsCommand contract
pd agents
/docs/cli/agents
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
pd swarm
human display plus --json machine output
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 agents reference: daemon health, discovery, and message-loop patterns these pages keep pointing back to.
Common ways this command shows up in practice
pd agents 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 agents; aliases resolve to the same contract.
Options that change command behavior
--active
Filter output to currently active records.
--json
Return machine-readable JSON instead of the human display.
Examples
Run pd agents from a coordinated checkout
pd agents
Runs the pd agents command family and prints the resulting Port Daddy state, ids, or readiness/error details.
Find this command from the full CLI reference
pd help agentsopen /docs/cli/agents
The help topic and docs route both describe pd agents, including aliases, flags, and source provenance.