agent workers

ddx agent workers

Show running agent workers and their current bead

Synopsis

Show all running agent workers and the bead each is currently executing.

Server-submitted workers (started via ddx work) are fetched from the running ddx server. Local workers (started with –local) are detected by scanning active attempt worktrees in the project.

Examples: ddx agent workers ddx agent workers –json ddx agent workers –watch ddx agent workers –project /path/to/project

ddx agent workers [flags]

Options

  -h, --help             help for workers
      --json             Emit raw JSON array
      --project string   Project root to query (default: detected from CWD)
      --watch            Re-render every 2s until Ctrl-C

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 output

SEE ALSO

• ddx agent - Invoke AI agents with harness dispatch, quorum, and session logging
• ddx agent workers stop - Gracefully stop running agent workers

Auto generated by spf13/cobra on 21-Apr-2026