Skip to content

agent run

ddx agent run

Invoke an agent with a prompt

ddx agent run [flags]

Options

      --effort string        Reasoning effort level
      --harness string       Harness name (default from config)
      --harnesses string     Comma-separated harnesses for quorum
  -h, --help                 help for run
      --json                 Output as JSON
      --model string         Model override
      --permissions string   Permission level: safe, supervised, unrestricted (overrides config)
      --prompt string        Path to prompt file
      --quorum string        Quorum strategy: any, majority, unanimous
      --record               Record prompt→response pair for virtual harness replay
      --text string          Inline prompt text
      --timeout string       Timeout duration (e.g. 30s, 5m)
      --worktree string      Create/reuse a git worktree for the run

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
Auto generated by spf13/cobra on 6-Apr-2026