プロジェクトごとの環境変数をmise.tomlで管理したい MISE_DATA_DIRのようなMISE_*環境変数はmise自体の動作を制御するものだが、mise setで設定するのはそれとは別に、プロジェクトで使う任意の環境変数である。mise.tomlの[env]セクションに書いておくと、mise activate済みのシェルやタスク実行時に自動的に反映される。

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

ツール名がどのバックエンドで解決されているか確認したい mise use jqのように短いツール名を指定すると、miseは内部のレジストリを参照して、実際にどのバックエンド(aqua、asdf、cargo、goなど)からインストールするかを自動的に決める。mise registryを使うと、この対応関係を確認できる。

mise-actionなしでもmiseをセットアップできる jdx/mise-actionを使わなくても、mise公式のインストールスクリプトを使えばGitHub Actions上でmiseをセットアップできる。mise-actionが内部で何を自動化しているかを知るために、手動セットアップと比較する。

モノレポのサブディレクトリにあるmise.tomlを読み込みたい jdx/mise-actionは既定でリポジトリのルートディレクトリでmise installを実行する。モノレポ構成でmise.tomlがサブディレクトリにある場合、ルートディレクトリにはmise.tomlが存在しないため、そのままでは目的のツールがインストールされない。working_directory入力を使うと、mise-actionがmise installなどを実行するディレクトリを指定できる。

mise.tomlの一部のツールだけインストールしたい jdx/mise-actionは既定でmise installを実行し、mise.tomlに定義した全ツールをインストールする。ジョブによって使うツールが異なるモノレポなどでは、ジョブごとに一部のツールだけインストールしたい場合がある。install_args入力を使うと、mise installに渡す引数を指定し、インストール対象を絞り込める。

GitHub APIのレート制限でツールのインストールに失敗する jdx/mise-actionは、ツールの最新バージョン確認やリリースアセットのダウンロードにGitHubのAPIを使う。GitHub APIは未認証のアクセスに対して低いレート制限がかかっている。多くのワークフローを同時に実行する環境ではこの制限に引っかかり、インストールに失敗する場合がある。github_token入力を使うと、GitHubの認証情報でAPIリクエストを認証し、レート制限を緩和できる。

CIでもmise.tomlに定義したタスクをそのまま使いたい 【mise】mise runでタスクを定義して実行する で紹介したmise runは、ローカルでもCIでも同じmise.tomlのタスク定義をそのまま実行できる。jdx/mise-actionでセットアップした後にmise runを実行するだけで、ビルドやテストといったタスクをGitHub Actions上でも実行できる。

レジストリに無いツールをasdf互換プラグインで使いたい miseはツールごとにコアやaquaなど複数のバックエンドを内蔵しており、mise useでツール名を指定すると、レジストリに登録された優先順位に従って自動的にバックエンドが選ばれる。ただしセキュリティ上の懸念から 、レジストリへの新規ツール登録ではasdfやvfoxのバックエンドは受け付けられなくなっており、新規に対応させたいツールはaquaバックエンドへの登録が推奨されている。レジストリに登録されていないツールをどうしても使いたい場合は、mise pluginsでasdf互換の外部プラグインを自分で追加して管理する。

mise本体を最新バージョンに更新したい mise installやmise useでインストールするのはmise管理下のツールのバージョンで、mise自体のバージョンは別に管理されている。mise自体を最新版に更新するにはmise self-updateを使う。