mise.toml reference
Every key mise reads from a mise.toml: its type, what it does and where it goes, generated from schema/mise.json so it matches this version of mise.
tools285tool_alias5tool_config1plugins1wrappers5
env33vars15redactionssecrets2
tasks96task_config18task_templates40monorepo15monorepo_root
hooks17watch_files4shell_alias1
settingsincludemin_version2doctor9_
deps27oci16daemons23daemon_groups2daemons_settings2daemon_providers12
bootstrap364dotfiles27dotfile_groups10history10
alias→dotenvenv_fileenv_pathexperimental_monorepo_root
Tools
commands that intercept a binary name before delegating to the active toolset
Command wrappers guide →Environment
Sources for mise secrets: values resolved only when mise starts a task or mise x command that was granted them
fnox guide →Tasks
Hooks and shell
Config file
config files merged into this one, ranking just below it: a local path (relative to this file), git::<url>//<path>.toml?ref=<ref> or oci::<registry>/<repo>[:tag|@sha256:<digest>] (the artifact holds a mise.toml)
include guide →Project diagnostic checks, run explicitly with mise doctor project
Project diagnostics guide →Project services
Experimental project daemons: custom pitchfork commands or managed presets
Daemons guide →Experimental project-wide daemon options
Ports, URLs, and worktrees guide →Experimental shared servers owned by the user
Share daemons across projects guide →Machine setup
bootstrap364machine-global bootstrapping (system packages, repos, macOS defaults, launchd agents, login shell)
Bootstrap guide →dotfiles27dotfiles applied with mise dotfiles apply or mise bootstrap, keyed by target path or a logical name when every variant overrides the target
Dotfiles guide →named directory trees of dotfiles, applied with mise dotfiles apply or mise bootstrap while [bootstrap] dotfile_groups selects them (or is unset)
Dotfile groups guide →history10dotfiles history: what is never captured, reload commands, and the setup repository (https://mise.jdx.dev/history.html)
Dotfiles history guide →