Mise File Tasks

Overview

Mise file tasks are standalone scripts (bash, node, python, etc.) located in mise-tasks/ or .mise/tasks/ that behave like full CLI commands. They support argument parsing, help generation, and dependency management via special comment directives.

When to Use

• Complex Logic: When a task is too long for a single line in mise.toml.
• Arguments: When you need flags (--force), options (--env prod), or positional arguments.
• Monorepo: When organizing tasks across multiple projects (//frontend:build).
• Polyglot: When you want to write tasks in Node, Python, or Ruby instead of Bash.

Core Pattern

1. File Location

Place scripts in:

• ./mise-tasks/ (Recommended)
• ./.mise/tasks/
• Any directory configured in mise.toml under [tasks]