Skip to main content
CLI/pd spawn kill <agent>
CLI command · v3.30.6

pd spawn kill <agent>

Kill a running spawned agent.

Syntax

Run pd spawn kill <agent> like this

pd spawn kill agent-1234
API spec

Command contract

Canonical command

pd spawn kill <agent>

Reference route

/docs/cli/spawn-kill

Reference group

Agents, Actors, Fleets, And Spawn Control

Runtime path

daemon-backed CLI command

Source

cli/commands/agents.ts, cli/commands/actors.ts, cli/commands/spawn.ts, cli/commands/fleet.ts, cli/commands/quorum.ts

Aliases

none

Output mode

human display with command-specific state changes

Page type

generated API spec from the source-backed catalog

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 spawn kill <agent> 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 spawn kill <agent> 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 spawn kill <agent>; aliases resolve to the same contract.

Examples

Example 01

Run pd spawn kill <agent> from a coordinated checkout

CLI
pd spawn kill agent-1234
Output
Runs the pd spawn kill <agent> 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 spawn
open /docs/cli/spawn-kill
Output
The help topic and docs route both describe pd spawn kill <agent>, including aliases, flags, and source provenance.