agent workers stop
ddx agent workers stop
Gracefully stop running agent workers
Synopsis
Gracefully terminate one or more running agent workers.
The server sends SIGTERM to the worker’s process group, waits for the configured grace window, and escalates to SIGKILL if the leader is still alive. The worker’s bead claim is released and a bead.stopped event is appended to the tracker before the kill, so claims are not leaked even when the full grace elapses.
Examples: ddx agent workers stop worker-20260418T100000-abcd ddx agent workers stop –all-over 1h ddx agent workers stop –state running ddx agent workers stop –bead ddx-abc12345
ddx agent workers stop [worker-id] [flags]Options
--all-over duration Stop every running worker older than this duration
--bead string Stop the worker assigned to the given bead id
-h, --help help for stop
--json Emit one JSON object per worker acted on
--project string Project root to query (default: detected from CWD)
--state string Stop every worker in the given state (e.g. running)Options inherited from parent commands
--config string config file (default is $HOME/.ddx.yml)
--library-base-path string override path for DDx library location
-v, --verbose verbose outputSEE ALSO
- ddx agent workers - Show running agent workers and their current bead