mise.tomlを書き換えずに別バージョンで動作確認したい 古いバージョンでの挙動を確認したいときなど、mise.tomlを書き換えずにその場限り別バージョンのツールを使いたい場面がある。mise execを使うと、mise.tomlを変更せずに指定したバージョンでコマンドを実行できる。

npmのグローバルインストールなどで追加したコマンドが実行できない miseはインストールしたツールごとに、実体を呼び出す小さな仲介役(shim)を~/.local/share/mise/shimsに生成する。mise installでインストールした直後はshimも自動生成されるが、miseの管理外の方法でツール本体のディレクトリに新しい実行ファイルを追加した場合、shimは自動的には作られない。mise reshimを実行すると、インストール済みツールの実体を再スキャンし、不足しているshimをまとめて生成する。

mise.tomlのバージョン範囲内で新しいバージョンが出ていないか確認したい mise.tomlにjq = "1.8"のようにバージョンを範囲指定していると、その範囲内でより新しいパッチバージョンが出ていても自動では切り替わらない。mise outdatedで更新可能なバージョンを確認し、mise upgradeでアップグレードできる。

GitHub Actionsのワークフローでmise.tomlに書いたツールを使いたい ローカルではmise installを実行すればよいが、GitHub Actionsのワークフロー上でも同じようにmise.tomlに書いたツールをセットアップしたい。jdx/mise-action を使うと、ワークフロー上にmiseをインストールし、リポジトリのmise.tomlに書かれたツールをそのまま使えるようになる。

使わなくなったツールのバージョンをディスクから消したい mise install <tool>@<version>でバージョンを指定してインストールを繰り返していると、使わなくなった古いバージョンがディスクに残り続ける。mise uninstallを使うと、インストール済みのツールを個別に削除できる。

mise installしてもコマンドの実体が切り替わらない mise.tomlにツールを記述してmise installを実行しても、シェルで直接コマンド名を打ったときに使われる実体は自動的には切り替わらない。jqのようにシステムにも同名のコマンドがインストール済みの場合、そちらが優先されたままになる。mise activateをシェルに組み込むと、ディレクトリごとにmise.tomlで指定したバージョンへコマンドの解決先が自動的に切り替わる。

asdfから移行するときに.tool-versionsを書き換えたくない asdfはプロジェクトで使うツールのバージョンを.tool-versionsというファイルで管理する。miseは.tool-versionsをそのまま読み込めるため、asdfからmiseへ移行する際に.tool-versionsを書き換える必要はない。

mise.tomlに何を書けるのか把握したい miseはプロジェクトで使うツールのバージョンや環境変数、タスクをmise.tomlという設定ファイルで管理する。mise.tomlには[tools]以外にもいくつかのセクションがあり、書ける内容やファイルの置き場所にはルールがある。

miseは、プロジェクトごとに使うツールのバージョンをmise.tomlで管理するツールである。1つのコマンドが担う役割は小さく分かれているため、目的に応じたコマンドを個別に把握しておくと使いやすい。ここではmiseの主要なコマンドを目的別に整理し、それぞれの使い方を解説した記事へリンクする。

ビルドやテストのコマンドをmise.tomlにまとめて管理したい プロジェクトごとに使うnpm run buildやmake testのようなコマンドを、READMEやシェルスクリプトへ散らばらせずmise.tomlにまとめて定義しておきたい場合がある。miseはmise.tomlにタスクを定義し、mise runで実行できるタスクランナー機能を備えている。