mise link

• Usage: mise link [-f --force] <TOOL@VERSION> <PATH>
• Aliases: ln
• Effect: modifies state
• Source code: src/cli/link.rs

Symlink a tool version into mise

Use this to register an install that was compiled by hand or built with another tool. mise uses the version exactly as written, such as node@24.11.0 or a name of your own like node@brew; latest, aliases, and channels are rejected.

Arguments

• <TOOL@VERSION> — Tool and version to create a symlink for
• <PATH> — Directory of the existing installation, such as ~/.nvm/versions/node/v24.11.0

Flags

• -f --force — Replace an existing installation of this version
• -h --help — Print help

Examples

Link a node that node-build built into ~/.nodes/24.11.0

mise link node@24.11.0 ~/.nodes/24.11.0

Register Homebrew's node as node@brew; then run mise use node@brew

mise link node@brew "$(brew --prefix node)"

Related documentation

• Development tools.
• All commands.
• Global flags and argument syntax.