mise を GitHub Action で使う際に不要なツールのインストールを避けて最適化する (.miserc.toml)

mise GitHub Actions

2026-01-28 • 更新: 2026-01-28

mise を GitHub Actions にも導入するにあたって、少し詰まったことがあったのと、導入して良さそうに思ったことをまとめます。

mise とは

Home | mise-en-place

mise-en-place documentation

mise.jdx.dev

mise は、開発環境のツールバージョン管理ツールです。以前はなんとかenv などで管理していた言語のバージョン管理に加えて、npm などでインストールできるツールも一括で管理できます。

また、mise にはタスクランナーとしての側面もあります。個人的にはこれが結構気に入っていてます。

私は JS で開発することが多いのですが、package.json だと複雑なコマンドを定義しづらいので、最近は mise で定義することも増えてきました。

以下のように toml で開発環境の設定をまとめることができます。

# ツールの管理
[tools]
node = "24.13.0"
gh = "latest"
"npm:npm-check-updates" = "19.3.2"

# 環境変数の管理
[env]
NODE_ENV = "development"

# タスクの管理
[tasks.clean]
run = ["rm -rf node_modules", "rm package-lock.json"]

[tasks.clean-install]
description = "説明も書けます"
depends = ["clean"]     # コメントも書ける
run = ["npm install"]

GitHub Actions での導入

mise でのバージョン管理を本格導入する場合、GitHub Actions などの CI 環境にも導入したくなります。

導入自体は簡単で jdx/mise-action を使うだけです。

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: jdx/mise-action@v3
      # 以降、mise でインストールされたツールを利用可能

問題

導入自体は簡単なのですが、単に入れると開発環境でしか使わないツールまでインストールされるため、次のような問題が発生します。

特にキャッシュがない場合に action の実行時間が長くなる
キャッシュのサイズが大きくなる
開発用のツールのインストールことで問題が発生する可能性もあるかも

解決法

mise v2026.1.1 で導入された .miserc.toml と MISE_ENV 環境変数を使う方法で解決できます。
この機能を使い mise の設定ファイルを分割して、環境ごとに必要なツールを分けたり、共通化したりします。

.miserc.toml は MISE_ENV を設定するためだけのファイルです。

MISE_ENV は読み込む設定ファイルを切り替えるためのもので、以下の優先順位で設定ファイルが読み込まれます。

mise.{MISE_ENV}.local.toml
mise.local.toml
mise.{MISE_ENV}.toml
mise.toml

例えば、以下のように設定します。

env = ["development"]

# 共通設定
[tools]
node = "24.13.0"

# 開発環境専用設定
[tools]
"npm:npm-check-updates" = "19.3.2"
gh = "latest"

GitHub Actions 側では MISE_ENV を ci に設定することで、CI 用のツール定義もできます

# CI 環境専用設定
[tools]
# ここには CI 専用のツールを定義できます

jobs:
  build:
    runs-on: ubuntu-latest
    env:
      MISE_ENV: ci # CI 環境を指定
    steps:
      - uses: actions/checkout@v6
      - uses: jdx/mise-action@v3
      # 以降、mise でインストールされたツールを利用可能