{
  "id": "woodpecker-cli",
  "name": "woodpecker-cli",
  "homepage": "https://woodpecker-ci.org/docs/cli",
  "description": "CLI client for the Woodpecker Continuous Integration server",
  "executables": [
    "woodpecker-cli"
  ],
  "dotfiles": {
    "paths": [
      "~/.config/woodpecker/contexts.json",
      "~/.config/woodpecker/config.json",
      "~/Library/Application Support/woodpecker/contexts.json",
      "~/Library/Application Support/woodpecker/config.json",
      "%LOCALAPPDATA%/woodpecker/contexts.json",
      "%LOCALAPPDATA%/woodpecker/config.json"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Woodpecker CLI",
    "description": "Run a pipeline locally with exec, with the common global server options. Auth tokens (kept in the OS keyring), metadata overrides and per-backend options are not covered.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "cli-docs",
        "kind": "manual",
        "url": "https://woodpecker-ci.org/docs/cli",
        "revision": "2026-10-27",
        "evidence": "--log-level=\"\": set logging level (default: info)\n--server, -s=\"\": server address\n--skip-verify: skip ssl verification (default: false)\n"
      }
    ],
    "field": [
      {
        "id": "server",
        "label": "Server address",
        "type": "url",
        "option": [
          "--server",
          "-s"
        ],
        "sources": [
          "cli-docs"
        ]
      },
      {
        "id": "skip_verify",
        "label": "Skip TLS verification",
        "type": "boolean",
        "option": [
          "--skip-verify"
        ],
        "sources": [
          "cli-docs"
        ]
      },
      {
        "id": "log_level",
        "label": "Log level",
        "type": "string",
        "option": [
          "--log-level"
        ],
        "suggestions": [
          {
            "value": "debug",
            "label": "debug"
          },
          {
            "value": "info",
            "label": "info"
          },
          {
            "value": "warn",
            "label": "warn"
          },
          {
            "value": "error",
            "label": "error"
          }
        ],
        "sources": [
          "cli-docs"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "server",
          "log_level",
          "skip_verify"
        ]
      }
    ],
    "subcommand": [
      {
        "path": [
          "exec"
        ],
        "label": "Run a pipeline locally",
        "description": "Execute a pipeline from a local repository.",
        "source": [
          {
            "id": "cli-docs",
            "kind": "manual",
            "url": "https://woodpecker-ci.org/docs/cli",
            "revision": "2026-10-27",
            "evidence": "--backend-engine=\"\": backend engine to run pipelines on (default: auto-detect)\n--local: run from local directory (default: true)\n--repo-path=\"\": path to local repository\n--timeout=\"\": pipeline timeout (default: 1h0m0s)\n--volumes=\"\": pipeline volumes\n--network=\"\": external networks\n"
          }
        ],
        "field": [
          {
            "id": "repo_path",
            "label": "Repository path",
            "type": "path",
            "path": {
              "kind": "directory",
              "role": "input"
            },
            "option": [
              "--repo-path"
            ],
            "sources": [
              "cli-docs"
            ]
          },
          {
            "id": "timeout",
            "label": "Pipeline timeout",
            "description": "Duration such as 30m or 1h.",
            "type": "string",
            "option": [
              "--timeout"
            ],
            "sources": [
              "cli-docs"
            ]
          },
          {
            "id": "backend_engine",
            "label": "Backend engine",
            "type": "string",
            "option": [
              "--backend-engine"
            ],
            "suggestions": [
              {
                "value": "docker",
                "label": "docker"
              },
              {
                "value": "local",
                "label": "local"
              }
            ],
            "sources": [
              "cli-docs"
            ]
          },
          {
            "id": "volumes",
            "label": "Volumes",
            "type": "string",
            "option": [
              "--volumes"
            ],
            "sources": [
              "cli-docs"
            ]
          },
          {
            "id": "network",
            "label": "External networks",
            "type": "string",
            "option": [
              "--network"
            ],
            "sources": [
              "cli-docs"
            ]
          }
        ],
        "task": [
          {
            "id": "exec",
            "label": "Run pipeline",
            "fields": [
              "repo_path",
              "timeout"
            ],
            "required": []
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "repo_path",
              "timeout"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "backend_engine",
              "volumes",
              "network"
            ]
          }
        ]
      }
    ]
  }
}