【mise】miseコマンドまとめ

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

インストール・バージョン管理

【mise】mise installで設定ファイルに書いたツールをインストールする mise.tomlに記述したツールを実際にダウンロード・インストールする。
【mise】mise useでプロジェクトに使うツールのバージョンを設定する mise.tomlへのツールの追記とインストールを1つのコマンドで行う。
【mise】mise use --globalで全体的に使うツールのバージョンを設定するプロジェクトを問わず共通で使うツールのバージョンを設定する。
【mise】mise lsでインストール済みツールの一覧を確認する mise管理下のツールとバージョンの一覧を確認する。
【mise】mise currentで現在有効なツールのバージョンを確認するカレントディレクトリで現在有効なバージョンだけをシンプルに表示する。
【mise】mise.tomlの書き方の基本 mise.tomlの主なセクションやファイル名のバリエーション、階層的なマージのルールを把握する。
【mise】.tool-versionsとの互換性 asdfの.tool-versionsをそのまま使う方法と、mise.tomlへの変換方法を確認する。
【mise】mise uninstallでインストール済みツールを削除する使わなくなったツールのバージョンをディスクから削除する。
【mise】mise outdated/mise upgradeでツールをアップグレードするバージョン範囲内の更新確認と、--bumpによる範囲自体の更新ができる。
【mise】mise execで一時的にツールバージョンを切り替えてコマンド実行する mise.tomlを書き換えずに、指定したバージョンでコマンドを1回だけ実行する。

パス・実行ファイルの確認

【mise】mise whereでツールのインストールパスを確認するツールのインストールディレクトリのパスを確認する。
【mise】mise whichで実行ファイルの実体パスを確認するコマンド名から実行ファイル本体のパスを確認する。
【mise】mise reshimでshimを再生成する mise管理外の方法で追加したコマンドのshimを作り直す。

タスクランナー

【mise】mise runでタスクを定義して実行する mise.tomlにタスクを定義し、mise runで実行する。

設定・診断

【mise】mise activateでシェルにmiseを組み込むシェルにフックを組み込み、ディレクトリ移動でコマンドの解決先を自動的に切り替える。
【mise】mise trustで設定ファイルを信頼するコードの実行や環境に影響しうるmise.tomlを明示的に信頼する。
【mise】mise doctorで環境の問題を診断する miseの動作状況をまとめて確認し、問題や警告を検出する。

GitHub Actions

【mise】mise-actionの基本的な使い方 GitHub Actionsのワークフロー上でmiseをセットアップし、mise.tomlに書いたツールを使う。