pd swarm
pd swarm is an alias for pd agents. List registered agents.
Run pd swarm like this
pd swarmCommand contract
pd agents
/docs/cli/swarm
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 swarm reference: daemon health, discovery, and message-loop patterns these pages keep pointing back to.
Common ways this command shows up in practice
pd swarm 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 pd agents in automation when you want the canonical spelling; pd swarm resolves to the same command 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 swarm from a coordinated checkout
pd swarm
Runs the pd swarm 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.