verdict profile use

Source command definition

Select a global default or a project profile

Runs locally. Effects: write profile selection.

Arguments and flags

Argument	Type	Required	Default	Description
<name>	positional	yes	No parser default	Profile name
--project	boolean	no	false	Use the project selection instead of the global default
--json	boolean	no	false	Output as JSON

--help (-h) shows command help without executing the command. Boolean flags support --no-<flag>. Defaults stated in descriptions may be resolved by the handler or configuration rather than the argument parser.

Input

Required profile name; —project selects it for the project instead of the global default. Stdin is unsupported.

File input: unsupported. Standard input: unsupported.

Result

{
  "kind": "json-schema",
  "schema": {
    "type": "object",
    "required": [
      "completed",
      "warnings"
    ],
    "additionalProperties": false,
    "properties": {
      "completed": {
        "type": "boolean"
      },
      "name": {
        "type": "string",
        "nullable": true
      },
      "target": {
        "type": "string",
        "enum": [
          "global",
          "project"
        ],
        "nullable": true
      },
      "warnings": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    }
  }
}

By default, the command renders human-readable records. --json writes one JSON result to stdout. Operational failures use status 1; JSON failures contain an error object with code and message. See shared output semantics.

Exit status

• 0: the command completed its operation.

Argument, I/O, and other failures handled by the CLI runner use status 1.

Examples

verdict profile use development --project