{
  "description": "Run a Docker Agent configuration interactively or headless. Sandbox, worktree, hook, remote and recording options are left out.",
  "name": "docker-agent",
  "subcommands": [
    {
      "name": "run",
      "description": "Run an agent",
      "options": [
        {
          "names": [
            "--exec"
          ],
          "description": "Non-interactive (headless)"
        },
        {
          "names": [
            "--agent",
            "-a"
          ],
          "description": "Agent name",
          "args": {
            "name": "agent",
            "isOptional": false
          }
        },
        {
          "names": [
            "--model"
          ],
          "description": "provider/model, or agent=provider/model.",
          "args": {
            "name": "model",
            "description": "provider/model, or agent=provider/model.",
            "isOptional": false,
            "suggestions": [
              {
                "name": "anthropic/claude-sonnet-4-5",
                "description": "Anthropic Claude Sonnet 4.5"
              },
              {
                "name": "openai/gpt-4o",
                "description": "OpenAI GPT-4o"
              }
            ]
          }
        },
        {
          "names": [
            "--safety"
          ],
          "description": "Tool approval mode",
          "args": {
            "name": "safety",
            "isOptional": false,
            "suggestions": [
              {
                "name": "strict",
                "description": "Strict (ask for everything)"
              },
              {
                "name": "balanced",
                "description": "Balanced (auto-approve safe calls)"
              },
              {
                "name": "restricted",
                "description": "Restricted (deny the rest)"
              },
              {
                "name": "autonomous",
                "description": "Autonomous"
              }
            ]
          }
        },
        {
          "names": [
            "--yolo"
          ],
          "description": "Auto-approve tool calls",
          "isDangerous": true
        },
        {
          "names": [
            "--session"
          ],
          "description": "Session id or relative ref such as -1 for the newest.",
          "args": {
            "name": "session",
            "description": "Session id or relative ref such as -1 for the newest.",
            "isOptional": false
          }
        },
        {
          "names": [
            "--prompt-file"
          ],
          "description": "Extra context files",
          "args": {
            "name": "prompt_file",
            "isOptional": false,
            "isVariadic": true,
            "template": "filepaths"
          },
          "isRepeatable": true
        },
        {
          "names": [
            "--working-dir"
          ],
          "description": "Working directory",
          "args": {
            "name": "working_dir",
            "isOptional": false,
            "template": "folders"
          }
        },
        {
          "names": [
            "--last"
          ],
          "description": "Requires headless mode."
        },
        {
          "names": [
            "--json"
          ],
          "description": "JSON output"
        },
        {
          "names": [
            "--dry-run"
          ],
          "description": "Validate only"
        },
        {
          "names": [
            "--lean"
          ],
          "description": "Lean inline TUI"
        },
        {
          "names": [
            "--debug",
            "-d"
          ],
          "description": "Debug logging"
        }
      ],
      "args": [
        {
          "name": "config",
          "description": "A .yaml, .yml or .hcl file; omit to use docker-agent.yaml in the current directory or the built-in agent.",
          "isOptional": true,
          "template": "filepaths"
        },
        {
          "name": "messages",
          "description": "Queued in order; each is processed in sequence.",
          "isOptional": true,
          "isVariadic": true
        }
      ]
    }
  ]
}