{
  "id": "bzt",
  "name": "Taurus",
  "homepage": "https://gettaurus.org/",
  "description": "An open-source automation framework for performance testing.",
  "executables": [
    "bzt"
  ],
  "platforms": [
    "macos",
    "linux"
  ],
  "dotfiles": {
    "paths": [
      "~/.bzt-rc"
    ],
    "exclude": [],
    "secret": [],
    "secret_paths": [
      {
        "file": "~/.bzt-rc",
        "format": "yaml",
        "match": {
          "key_path": [
            "modules.cloud.token"
          ]
        }
      }
    ]
  },
  "commands": {
    "format": 1,
    "label": "Run a test",
    "description": "Run Taurus with config files or URLs. Aliases and JMX shorthand are passed as plain arguments; cloud and module settings go through overrides.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "docs",
        "kind": "manual",
        "url": "https://raw.githubusercontent.com/Blazemeter/taurus/HEAD/site/dat/docs/CommandLine.md",
        "revision": "HEAD 2026-10-27",
        "evidence": "Command-line tool is named `bzt` and invoked like `bzt <options> \\[configs]`. Possible options are:\n  - `-q, --quiet` - only errors and warnings printed to console\n  - `-n, --no-system-configs` - skip `/etc/bzt.d` and `~/.bzt-rc` (see below)\n  - `-v, --verbose` - prints all logging messages to console (sometimes _a lot_)\n  - `-l LOG, --log=LOG` - change log file location, by default is `bzt.log` in current directory\n  - `-o OPTION, --option=OPTION` override some config settings from command line, may be used multiple times\nbzt http://blazedemo.com/\nbzt config-1.yml config-2.json\n"
      }
    ],
    "field": [
      {
        "id": "quiet",
        "label": "Quiet",
        "description": "Only errors and warnings on the console.",
        "type": "boolean",
        "option": [
          "--quiet",
          "-q"
        ],
        "sources": [
          "docs"
        ]
      },
      {
        "id": "verbose",
        "label": "Verbose",
        "type": "boolean",
        "option": [
          "--verbose",
          "-v"
        ],
        "sources": [
          "docs"
        ]
      },
      {
        "id": "no_system_configs",
        "label": "Skip system configs",
        "description": "Skip /etc/bzt.d and ~/.bzt-rc.",
        "type": "boolean",
        "option": [
          "--no-system-configs",
          "-n"
        ],
        "sources": [
          "docs"
        ]
      },
      {
        "id": "log",
        "label": "Log file",
        "description": "Defaults to bzt.log in the current directory.",
        "type": "path",
        "option": [
          "--log",
          "-l"
        ],
        "path": {
          "kind": "file",
          "role": "output",
          "must_exist": false
        },
        "effect": "overwrite",
        "sources": [
          "docs"
        ]
      },
      {
        "id": "override",
        "label": "Config override",
        "description": "path=value, for example provisioning=cloud. May be repeated.",
        "type": "string",
        "option": [
          "--option",
          "-o"
        ],
        "multiple": true,
        "sources": [
          "docs"
        ]
      },
      {
        "id": "configs",
        "label": "Configs or URLs",
        "description": "YAML/JSON config files, .jmx files or a target URL.",
        "type": "string",
        "position": 0,
        "multiple": true,
        "sources": [
          "docs"
        ]
      }
    ],
    "task": [
      {
        "id": "run",
        "label": "Run configs",
        "fields": [
          "configs",
          "override",
          "log"
        ],
        "required": [
          "configs"
        ]
      },
      {
        "id": "quick",
        "label": "Quick URL test",
        "fields": [
          "configs",
          "quiet"
        ],
        "required": [
          "configs"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "configs",
          "override",
          "log"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "quiet",
          "verbose",
          "no_system_configs"
        ]
      }
    ]
  }
}
