【mise】mise tool-aliasでツールバージョンにエイリアスを定義する

独自の名前でバージョンを指定したい

miseはnodeのlts-jodのように、一部のツールでLTSバージョンなどのエイリアスをあらかじめ用意している。mise tool-aliasを使うと、自分で任意のエイリアス名を定義できる。設定は~/.config/mise/config.toml(グローバル設定ファイル)に保存され、プロジェクトを問わず使える。

mise tool-alias setでバージョンにエイリアスを設定する

jqの1.7.1にstableというエイリアスを設定する。

$ mise tool-alias set jq stable 1.7.1

~/.config/mise/config.tomlに以下の内容が追記される。

[tool_alias.jq.versions]
stable = "1.7.1"

mise.tomlでエイリアス名を指定すると、実際のバージョンに解決される。

[tools]
jq = "stable"

$ mise current jq
1.7.1

mise tool-alias ls/getでエイリアスを確認する

mise tool-alias lsを実行すると、自分で定義したエイリアスに加えて、プラグイン側があらかじめ用意しているエイリアスも一覧で確認できる。

$ mise tool-alias ls
java  lts          25
jq    stable       1.7.1
node  lts          24
node  lts-argon    4
node  lts-boron    6
...
node  lts-jod      22

特定のツール・エイリアスの値だけを確認したい場合はmise tool-alias getを使う。

$ mise tool-alias get jq stable
1.7.1

ツール名自体にエイリアスを設定する

mise tool-aliasはバージョンだけでなく、ツール名自体のエイリアスも定義できる。バックエンド指定を含む値を渡すと、新しいツール名として使えるようになる。

$ mise tool-alias set myjq aqua:jqlang/jq

$ mise use myjq@latest
mise myjq@1.8.2      [1/2] install
mise myjq@1.8.2      [1/2] download jq-macos-arm64
...

myjqという短い名前で、aqua:jqlang/jqというバックエンド指定のツールを扱えるようになる。長いバックエンド指定を毎回書きたくない場合に使える。

mise tool-alias unsetでエイリアスを削除する

設定したエイリアスが不要になったらunsetで削除する。

$ mise tool-alias unset jq stable

<ALIAS>を省略すると、指定したツールのエイリアスをすべて削除する。

$ mise tool-alias unset jq