Skip to content

mise tasks validate

Validate tasks for common errors and issues

Arguments

[TASKS]…

Tasks to validate If not specified, validates all tasks

Flags

--errors-only

Only show errors (skip warnings)

--json

Output validation results in JSON format

Examples:

# Validate all tasks
$ mise task validate

# Validate specific tasks
$ mise task validate build test

# Output results as JSON
$ mise task validate --json

# Only show errors (skip warnings)
$ mise task validate --errors-only

Validation Checks:

The validate command performs the following checks:

• Circular Dependencies: Detects dependency cycles • Missing References: Finds references to non-existent tasks • Usage Spec Parsing: Validates #USAGE directives and specs • Timeout Format: Checks timeout values are valid durations • Alias Conflicts: Detects duplicate aliases across tasks • File Existence: Verifies file-based tasks exist • Directory Templates: Validates directory paths and templates • Shell Commands: Checks shell executables exist • Glob Patterns: Validates source and output patterns • Run Entries: Ensures tasks reference valid dependencies

Licensed under the MIT License. Maintained by @jdx and friends.