Shell aliases

Define shell aliases in mise.toml. In a Bash, Zsh or Fish shell where mise is activated, mise sets them when you enter the directory and removes them when you leave. Other shells ignore [shell_alias]; see shell feature support.

mise.toml

[shell_alias]
ll = "ls -la"
gs = "git status"

cd ~/myproject
ll       # runs ls -la
cd ~     # mise removes ll

Aliases exist only in your interactive shell. Tasks, mise exec and scripts do not see them, so define a task for a command that must also work in scripts and CI, or put a wrapper script on PATH with env._.path.

These are not tool aliases ([tool_alias]), which give names to tool versions.

Manage aliases from the CLI

mise shell-alias lists and edits aliases:

mise shell-alias ls               # aliases active in the current directory
mise shell-alias get ll           # prints ls -la
mise shell-alias set ll "ls -la"  # adds or updates ll in the global config
mise shell-alias unset ll         # removes ll from the global config

set and unset edit only the global config, ~/.config/mise/config.toml. To add a project alias, edit [shell_alias] in the project's mise.toml.

Parent and child directories

Aliases from a parent directory's config apply in its child directories, and a child's config can override them:

~/projects/mise.toml

[shell_alias]
build = "make build"

~/projects/myapp/mise.toml

[shell_alias]
build = "npm run build"  # overrides the parent's build

When you change an alias in config, mise updates it in the shell at the next prompt.

Templates

Alias values are Tera templates. Quote paths with the quote filter so directories that contain spaces work in Bash and Zsh:

mise.toml

[shell_alias]
proj = "cd {{config_root | quote}}"
src = "cd {{config_root | quote}}/src"

Examples

mise.toml

[shell_alias]
dev = "npm run dev"
t = "npm test"
dc = "docker compose -f docker-compose.dev.yml"
tf = "terraform -chdir=./infrastructure"

Avoid names of shell builtins such as test, which an alias would shadow in your interactive shell.

Limitations

• mise replaces an alias of the same name that your shell already defines, and does not restore it when you leave the directory.
• In safe mode (MISE_SAFE=1), mise ignores [shell_alias] from project config. Aliases from the global config still apply.