Skip to content

mise tasks rm ​

  • Usage: mise tasks rm [FLAGS] <TASKS>…
  • Aliases: remove
  • Effect: destructive — may delete or irreversibly overwrite
  • Source code: src/cli/tasks/rm.rs

Remove tasks

Removes a TOML task's [tasks.<name>] table from the config file that defines it, and deletes a file task's script. Without --env, --global or --path, mise uses the one file that defines each task and fails when several do; --path can also name a file task's script. Asks before removing anything unless --yes (MISE_YES=1) is set, and fails without a terminal to ask on.

Other tasks that depend on a removed task are left as they are; mise tasks validate reports them.

Arguments ​

  • <TASKS>… — Tasks to remove

Flags ​

  • -n --dry-run — Show what would be removed without removing it

  • -J --json — Print what was removed as JSON

  • -e --env <ENV> — Use mise.<ENV>.toml in the current directory, or .mise.<ENV>.toml if that exists

    --env local uses mise.local.toml, which is for tasks you keep to yourself. Not the same as the global -E, which only chooses which config files are loaded.

  • -g --global — Use the global config file

  • -p --path <PATH> — Use this config file, or the config file in this directory

  • -h --help — Print help

Examples ​

Remove the build task

mise tasks rm build

Remove two tasks from mise.local.toml without asking

mise tasks rm --env local --yes lint fmt

Show which file defines build without changing it

mise tasks rm --dry-run --json build
MIT LicenseCopyright © 2026jdx.dev