{
  "description": "Start the Droid coding agent with an optional first prompt, or run a task headlessly with the exec subcommand.",
  "options": [
    {
      "names": [
        "--append-system-prompt"
      ],
      "description": "Append to system prompt",
      "args": {
        "name": "append_system_prompt",
        "isOptional": false
      }
    },
    {
      "names": [
        "--append-system-prompt-file"
      ],
      "description": "Append system prompt from file",
      "args": {
        "name": "append_system_prompt_file",
        "isOptional": false,
        "template": "filepaths"
      }
    }
  ],
  "args": [
    {
      "name": "prompt",
      "description": "Initial prompt. Leave empty to start with an empty chat.",
      "isOptional": true
    }
  ],
  "name": "droid",
  "subcommands": [
    {
      "name": "exec",
      "description": "Run one prompt non-interactively with droid exec. Mission mode, tool allow/deny lists, spec mode and session tagging are left out.",
      "options": [
        {
          "names": [
            "--file",
            "-f"
          ],
          "description": "Prompt file",
          "args": {
            "name": "file",
            "isOptional": false,
            "template": "filepaths"
          }
        },
        {
          "names": [
            "--model",
            "-m"
          ],
          "description": "Model ID",
          "args": {
            "name": "model",
            "isOptional": false
          }
        },
        {
          "names": [
            "--auto"
          ],
          "description": "Omit for read-only. Low allows safe edits, medium local development, high push and deploy.",
          "args": {
            "name": "auto",
            "description": "Omit for read-only. Low allows safe edits, medium local development, high push and deploy.",
            "isOptional": false,
            "suggestions": [
              {
                "name": "low",
                "description": "Low (safe edits)"
              },
              {
                "name": "medium",
                "description": "Medium (local development)"
              },
              {
                "name": "high",
                "description": "High (CI/CD, push, deploy)"
              }
            ]
          }
        },
        {
          "names": [
            "--output-format",
            "-o"
          ],
          "description": "Output format",
          "args": {
            "name": "output_format",
            "isOptional": false,
            "suggestions": [
              {
                "name": "text",
                "description": "Text"
              },
              {
                "name": "json",
                "description": "JSON"
              },
              {
                "name": "stream-json",
                "description": "Stream JSON"
              }
            ]
          }
        },
        {
          "names": [
            "--session-id",
            "-s"
          ],
          "description": "Continue session",
          "args": {
            "name": "session_id",
            "isOptional": false
          }
        },
        {
          "names": [
            "--cwd"
          ],
          "description": "Working directory",
          "args": {
            "name": "cwd",
            "isOptional": false,
            "template": "folders"
          }
        },
        {
          "names": [
            "--reasoning-effort",
            "-r"
          ],
          "description": "Valid levels depend on the model.",
          "args": {
            "name": "reasoning_effort",
            "description": "Valid levels depend on the model.",
            "isOptional": false
          }
        },
        {
          "names": [
            "--use-spec"
          ],
          "description": "Plan first (spec mode)"
        },
        {
          "names": [
            "--list-tools"
          ],
          "description": "List available tools"
        },
        {
          "names": [
            "--skip-permissions-unsafe"
          ],
          "description": "Unsafe: only in disposable sandboxes.",
          "isDangerous": true
        }
      ],
      "args": [
        {
          "name": "prompt",
          "description": "Leave empty when reading the prompt from a file.",
          "isOptional": true
        }
      ]
    }
  ]
}