メインコンテンツへスキップ
Toolsbase Logo

mise コマンド一覧

開発ツールバージョン管理・タスクランナー・環境変数管理を一本化する mise の全コマンドリファレンス。カテゴリ検索とワンクリックコピーで開発中にすばやく確認できます。

使い方使い方を開く
  1. 1

    カテゴリで絞り込む

    ツール管理、タスクランナー、環境変数・シェル統合、設定・プラグイン、システム・保守を切り替えて目的の情報にすばやく到達できます。

  2. 2

    検索で詳細を探す

    検索欄でコマンド名、オプション解説、使用例をまとめて部分一致検索できます。

  3. 3

    コピーして実行

    カードのコピーボタンからコマンドを取得し、そのままターミナルで実行できます。

mise use

ツールをインストールし mise.toml に追記します。

ポイント

  • --global (-g): グローバル設定に追加。
  • --env <env>: 環境別設定ファイルに追加。

使用例

mise use node@22
Node.js 22をインストールし mise.toml に記録。
mise use --global python@3.12
Python 3.12をグローバルに設定。

mise install

ツールをインストールします（設定ファイルは変更しません）。

ポイント

  • --force (-f): 既存でも再インストール。
  • --verbose (-v): 詳細ログを表示。

使用例

mise install node@22
Node.js 22をインストール。
mise install
mise.toml に定義された全ツールをインストール。

mise ls

インストール済みツールの一覧を表示します。

ポイント

  • --current (-c): 現在有効なバージョンのみ表示。
  • --json (-J): JSON形式で出力。

使用例

mise ls
全インストール済みツールを一覧表示。
mise ls node
Node.jsのインストール済みバージョンを表示。

mise ls-remote

リモートで利用可能なバージョン一覧を表示します。

ポイント

  • --all: プレリリースを含む全バージョンを表示。
  • TOOL@PREFIX: プレフィックスでフィルタ。

使用例

mise ls-remote node
Node.jsの全利用可能バージョンを一覧。
mise ls-remote python@3.12
Python 3.12.xの全マイナーバージョンを表示。

mise latest

ツールの最新バージョンを表示します。

ポイント

  • TOOL@PREFIX: プレフィックスを指定して最新を検索。
  • --installed (-i): インストール済みの最新バージョンのみ。

使用例

mise latest node
Node.jsの最新安定版を表示。
mise latest python@3.12
Python 3.12系の最新バージョンを表示。

mise upgrade

ツールを最新版にアップグレードします。

ポイント

  • --interactive (-i): 対話的にアップグレード対象を選択。
  • --bump: mise.toml のバージョン指定も更新。

使用例

mise upgrade node
Node.jsを最新版にアップグレード。
mise upgrade
全ツールをアップグレード。

mise outdated

更新可能なツールを一覧表示します。

ポイント

  • --json (-J): JSON形式で出力。
  • --bump: mise.toml のバージョンも表示。

使用例

mise outdated
更新可能な全ツールを一覧表示。
mise outdated node
Node.jsに新しいバージョンがあるか確認。

mise uninstall

ツールをアンインストールします。

ポイント

  • --all: 指定ツールの全バージョンを削除。
  • --dry-run (-n): 実行せず確認のみ。

使用例

mise uninstall node@20
Node.js 20をアンインストール。
mise uninstall node --all
Node.jsの全バージョンを削除。

mise unuse

mise.toml からツール定義を削除します。

ポイント

  • --global (-g): グローバル設定から削除。
  • TOOL: 削除するツール名を指定。

使用例

mise unuse node
mise.toml から Node.js の定義を削除。
mise unuse --global python
グローバル設定から Python を削除。

mise prune

使われていないツールバージョンを削除します。

ポイント

  • --dry-run (-n): 削除対象の確認のみ。
  • TOOL: 特定ツールのみ対象にする。

使用例

mise prune
未使用の全バージョンを削除。
mise prune --dry-run
削除対象を確認（実行しない）。

mise where

ツールのインストールパスを表示します。

ポイント

  • TOOL@VERSION: バージョンを指定してパスを取得。
  • パスが見つからない場合はエラーを返します。

使用例

mise where node@22
Node.js 22のインストールディレクトリを表示。
mise where python
現在有効なPythonのパスを表示。

mise which

バイナリの実行パスを表示します。

ポイント

  • --plugin: バイナリを提供するプラグイン名を表示。
  • --version: バイナリのバージョンを表示。

使用例

mise which node
nodeコマンドの実パスを表示。
mise which python --version
pythonコマンドのバージョンを表示。

mise search

レジストリからツールを検索します。

ポイント

  • NAME: 検索キーワード。
  • レジストリ内の全ツールを対象に部分一致検索。

使用例

mise search rust
「rust」を含むツールを検索。
mise search linter
リンター関連ツールを検索。

mise link

既存のバイナリをツールとしてリンクします。

ポイント

  • TOOL@VERSION: ツール名とバージョンを指定。
  • PATH: リンク先のディレクトリパス。

使用例

mise link node@system /usr/local
システムのNode.jsをmiseで管理。
mise link python@custom ~/my-python
カスタムビルドのPythonをリンク。

mise registry

ツールレジストリを表示します。

ポイント

  • NAME: フィルタするツール名。
  • バックエンド（aqua、cargo、npm等）を含む情報を表示。

使用例

mise registry
登録済み全ツールを一覧表示。
mise registry node
Node.jsのレジストリ情報を表示。

mise run

定義済みタスクを実行します（mise <task名> でも可）。

ポイント

  • --timings (-t): 各タスクの実行時間を表示。
  • --force (-f): キャッシュを無視して再実行。

使用例

mise run build
buildタスクを実行。
mise run test -- --coverage
testタスクにオプションを渡して実行。

mise tasks ls

定義済みタスクの一覧を表示します。

ポイント

  • --extended (-x): 詳細情報を表示。
  • --json (-J): JSON形式で出力。

使用例

mise tasks ls
全タスクを一覧表示。
mise tasks ls --extended
ソースファイルと説明を含めて表示。

mise tasks add

新しいタスクを追加します。

ポイント

  • --file (-f): ファイルベースのタスクとして作成。
  • --description (-d): タスクの説明を指定。

使用例

mise tasks add build -- npm run build
buildタスクをインラインで追加。
mise tasks add lint --file
lintタスクをファイルベースで作成。

mise tasks edit

タスクファイルをエディタで開きます。

ポイント

  • TASK: 編集するタスク名。
  • $EDITOR で設定されたエディタを使用。

使用例

mise tasks edit build
buildタスクのファイルを編集。
mise tasks edit test
testタスクのファイルを編集。

mise tasks info

タスクの詳細情報を表示します。

ポイント

  • TASK: 表示するタスク名。
  • --json (-J): JSON形式で出力。

使用例

mise tasks info build
buildタスクの詳細を表示。
mise tasks info deploy --json
deployタスクの情報をJSON出力。

mise tasks deps

タスクの依存関係グラフを表示します。

ポイント

  • TASKS: 表示対象のタスク名（複数可）。
  • --dot: Graphviz DOT形式で出力。

使用例

mise tasks deps
全タスクの依存関係を表示。
mise tasks deps deploy --dot
deployタスクの依存グラフをDOT形式で出力。

mise tasks validate

タスク定義のバリデーションを行います。

ポイント

  • TASKS: 検証対象のタスク名。
  • 全タスクの設定整合性をチェック。

使用例

mise tasks validate
全タスクの定義を検証。
mise tasks validate build test
buildとtestタスクのみ検証。

mise watch

ファイル変更を監視してタスクを自動実行します。

ポイント

  • --glob (-g): 監視するファイルパターンを指定。
  • TASK: 実行するタスク名。

使用例

mise watch test
ファイル変更時にテストを自動実行。
mise watch -g 'src/**/*.ts' build
TypeScriptファイル変更時にビルド。

mise activate

シェルにmiseを統合します（.bashrc等に記述）。

ポイント

  • SHELL: シェルの種類（bash, zsh, fish）。
  • --shims: shim方式で統合（パフォーマンス重視）。

使用例

eval "$(mise activate zsh)"
.zshrcに追記してmiseを有効化。
eval "$(mise activate bash --shims)"
shim方式でbashに統合。

mise deactivate

シェル統合を無効化します。

ポイント

  • 現在のシェルセッションのmise統合を解除。
  • 設定ファイルの変更は行いません。

使用例

mise deactivate
現在のセッションでmiseを無効化。
mise deactivate && which node
無効化後にシステムのnodeパスを確認。

mise shell

現在のシェルセッションのみツールバージョンを変更します。

ポイント

  • TOOL@VERSION: 設定するツールとバージョン。
  • --unset (-u): セッション内の設定を解除。

使用例

mise shell node@20
このセッションのみNode.js 20を使用。
mise shell python@3.11 node@22
複数ツールのバージョンを一時変更。

mise exec

指定ツールのバージョンでコマンドを実行します。

ポイント

  • TOOL@VERSION: 使用するツールとバージョン。
  • -- COMMAND: 実行するコマンド。

使用例

mise exec node@20 -- node app.js
Node.js 20でapp.jsを実行。
mise exec python@3.12 -- pytest
Python 3.12でpytestを実行。

mise en

指定ディレクトリの環境をサブシェルで有効化します。

ポイント

  • DIR: 対象ディレクトリ。
  • サブシェルを終了するとツール設定が元に戻ります。

使用例

mise en ./my-project
my-projectの環境をサブシェルで開始。
mise en .
カレントディレクトリの環境でサブシェルを起動。

mise set

環境変数をmise.tomlに設定します。

ポイント

  • --file <file>: 書き込み先の設定ファイルを指定。
  • --env <env>: 環境別設定に追加。

使用例

mise set DATABASE_URL=postgres://localhost/mydb
DATABASE_URLを設定。
mise set --env staging API_KEY=xxx
staging環境にAPI_KEYを設定。

mise env

環境変数をシェル形式でエクスポートします。

ポイント

  • --json (-J): JSON形式で出力。
  • --shell (-s): 出力形式のシェルを指定。

使用例

mise env
現在の環境変数をexport形式で出力。
eval "$(mise env)"
環境変数を現在のシェルに適用。

mise unset

mise.tomlから環境変数を削除します。

ポイント

  • ENV_KEY: 削除する環境変数名。
  • --file <file>: 対象の設定ファイルを指定。

使用例

mise unset DATABASE_URL
DATABASE_URLを削除。
mise unset API_KEY SECRET_KEY
複数の環境変数を一括削除。

mise config ls

読み込まれている設定ファイルの一覧を表示します。

ポイント

  • --json (-J): JSON形式で出力。
  • 優先順位（近い設定が高優先）も確認可能。

使用例

mise config ls
有効な設定ファイルを優先順で表示。
mise config ls --json
設定ファイル情報をJSON出力。

mise config set

mise.tomlの設定値を変更します。

ポイント

  • KEY VALUE: 設定キーと値を指定。
  • --file <file>: 書き込み先のファイルを指定。

使用例

mise config set python_venv_auto_create true
Python仮想環境の自動作成を有効化。
mise config set jobs 8
並列実行数を8に設定。

mise trust

設定ファイルを信頼済みとしてマークします。

ポイント

  • CONFIG_FILE: 信頼する設定ファイル。
  • --untrust: 信頼を取り消す。

使用例

mise trust
カレントディレクトリの mise.toml を信頼。
mise trust ~/projects/app/mise.toml
指定パスの設定ファイルを信頼。

mise settings ls

miseの全設定を一覧表示します。

ポイント

  • --json (-J): JSON形式で出力。
  • --keys: 設定キーのみ表示。

使用例

mise settings ls
全設定を一覧表示。
mise settings ls --json
設定をJSON形式で出力。

mise settings set

miseの設定項目を変更します。

ポイント

  • SETTING VALUE: 設定名と値を指定。
  • 設定は ~/.config/mise/config.toml に保存。

使用例

mise settings set experimental true
実験的機能を有効化。
mise settings set legacy_version_file true
.node-version等のレガシーファイルを有効化。

mise plugins ls

インストール済みプラグインの一覧を表示します。

ポイント

  • --core (-c): コアプラグインも表示。
  • --urls (-u): GitリポジトリURLを表示。

使用例

mise plugins ls
インストール済みプラグイン一覧。
mise plugins ls --urls
プラグインのソースURLを含めて表示。

mise plugins install

プラグインをインストールします。

ポイント

  • PLUGIN: プラグイン名（短縮名またはURL）。
  • --force (-f): 既存でも再インストール。

使用例

mise plugins install elixir
Elixirプラグインをインストール。
mise plugins install custom https://github.com/user/asdf-custom.git
カスタムプラグインをGitURLから追加。

mise plugins uninstall

プラグインを削除します。

ポイント

  • PLUGIN: 削除するプラグイン名。
  • --purge (-p): プラグインデータも完全削除。

使用例

mise plugins uninstall elixir
Elixirプラグインを削除。
mise plugins uninstall custom --purge
カスタムプラグインとデータを完全削除。

mise plugins update

プラグインを最新版に更新します。

ポイント

  • PLUGIN: 更新するプラグイン名。
  • --all: 全プラグインを更新。

使用例

mise plugins update
全プラグインを最新に更新。
mise plugins update elixir
Elixirプラグインのみ更新。

mise fmt

mise.tomlをフォーマットします。

ポイント

  • --check: フォーマット結果のチェックのみ（変更しない）。
  • TOML標準に準拠したフォーマットを適用。

使用例

mise fmt
mise.tomlを整形。
mise fmt --check
フォーマット差分の確認のみ。

mise edit

mise.tomlをエディタで開きます。

ポイント

  • $EDITOR または $VISUAL で設定されたエディタを使用。
  • 設定ファイルがなければ新規作成。

使用例

mise edit
カレントディレクトリの mise.toml を編集。
EDITOR=code mise edit
VS Codeで mise.toml を開く。

mise doctor

環境の問題を診断します。

ポイント

  • PATH設定、プラグイン状態、設定整合性を確認。
  • 問題がある場合は修正方法を提示。

使用例

mise doctor
環境の問題を診断して一覧表示。
mise doctor 2>&1 | grep WARN
警告のみフィルタして確認。

mise version

miseのバージョンを表示します。

ポイント

  • インストール方法（cargo、brew等）も表示。
  • トラブルシューティング時の基本情報。

使用例

mise version
miseのバージョンを表示。
mise --version
バージョン番号のみ表示。

mise self-update

mise自身を最新版に更新します。

ポイント

  • VERSION: 特定バージョンを指定して更新。
  • --force (-f): 同バージョンでも再インストール。

使用例

mise self-update
miseを最新版に更新。
mise self-update 2025.1.0
指定バージョンに更新。

mise cache clear

キャッシュを削除します。

ポイント

  • PLUGIN: 特定プラグインのキャッシュのみ削除。
  • 全キャッシュを削除する場合は引数なし。

使用例

mise cache clear
全キャッシュを削除。
mise cache clear node
Node.jsのキャッシュのみ削除。

mise reshim

シム（shim）を再生成します。

ポイント

  • shim方式で統合している場合に使用。
  • ツールの追加・削除後にPATHを更新。

使用例

mise reshim
全シムを再生成。
mise reshim node
Node.js関連のシムのみ再生成。

mise completion

シェル補完スクリプトを生成します。

ポイント

  • SHELL: 対象シェル（bash, zsh, fish）。
  • シェル設定ファイルに追記して使用。

使用例

mise completion zsh > ~/.zfunc/_mise
zsh補完スクリプトを生成して保存。
mise completion bash >> ~/.bashrc
bash補完を.bashrcに追加。

mise generate github-action

GitHub Actions用のワークフローファイルを生成します。

ポイント

  • --write (-w): ファイルに直接書き出し。
  • mise.tomlのツール定義からCIステップを自動生成。

使用例

mise generate github-action --write
GitHub Actionsワークフローを生成して保存。
mise generate github-action
ワークフロー内容を標準出力で確認。

mise generate config

mise.tomlを自動生成します。

ポイント

  • --output (-o): 出力先ファイルパス。
  • 既存の .tool-versions 等から変換可能。

使用例

mise generate config
mise.tomlを対話的に生成。
mise generate config -o mise.toml
指定パスに設定ファイルを出力。

mise sync node

nvm/nodenvからNode.jsバージョンを同期します。

ポイント

  • 既存のnvm/nodenvインストールをmiseから利用可能に。
  • 重複インストールを避けてディスクを節約。

使用例

mise sync node
nvmのNode.jsバージョンをmiseに同期。
mise sync node --nvm
nvm環境からNode.jsバージョンを取り込み。

mise implode

miseを完全にアンインストールします。

ポイント

  • --config: 設定ファイルも削除。
  • --dry-run (-n): 削除対象の確認のみ。

使用例

mise implode
miseと全インストール済みツールを削除。
mise implode --dry-run
削除対象を確認（実行しない）。

mise（mise-en-place）とは

mise は開発ツールのバージョン管理・タスクランナー・環境変数管理を一本化したCLIツールです。asdf互換のプラグインエコシステムを活用しつつ、Rust製の高速動作と直感的なUIを提供します。Node.js、Python、Go、Ruby など多言語のランタイム管理に加え、Makefile代替のタスクランナー機能やディレクトリ単位の環境変数管理もカバーします。

主な機能

  • Node.js、Python、Go、Ruby など 数百以上のツールのバージョン管理
  • asdf互換プラグイン＋aqua、cargo、npm など多数のバックエンド対応
  • mise.toml によるプロジェクト単位の宣言的な設定管理
  • タスクランナー機能（Makefile/npm scripts の代替）
  • ディレクトリ単位の環境変数管理（direnv代替）
  • Rust製による高速なインストールとバージョン切り替え

活用シーン

  • チーム開発でランタイムバージョンを統一したい
  • asdfから高速な代替ツールに移行したい
  • Makefile/npm scripts をシンプルなタスクランナーに置き換えたい
  • プロジェクトごとに異なる環境変数を自動切り替えしたい
  • CI/CDパイプラインでツールセットアップを簡素化したい

よくある質問

miseとasdfの違いは何ですか？

miseはasdf互換のプラグインを使用できますが、Rust製のため高速に動作します。また、タスクランナー・環境変数管理・ロックファイルなどasdfにはない機能を内蔵しています。.tool-versionsファイルもそのまま読み込めるため、asdfからの移行は容易です。

miseのタスクランナー機能とは何ですか？

mise.toml にタスク定義を記述し、mise run <task名> で実行できる機能です。依存関係の定義、ファイル監視による自動実行（mise watch）、並列実行なども対応しています。Makefile や npm scripts の代替として使えます。

環境変数管理はどう使いますか？

mise set KEY=VALUE で mise.toml に環境変数を記録し、そのディレクトリに移動すると自動的に有効化されます。環境別設定（--env staging）やシークレットの暗号化保存にも対応しています。

activate方式とshim方式の違いは？

activate方式はシェルのフック機能を使い、ディレクトリ移動時に自動でバージョンを切り替えます。shim方式はPATHにshimディレクトリを追加する軽量な方式で、シェル起動が速くなります。一般的にはactivate方式が推奨されています。

CI/CDでmiseを使うにはどうすればよいですか？

mise generate github-action でGitHub Actions用のワークフローを自動生成できます。mise install --yes で対話的な確認をスキップでき、mise.lock ファイルで再現性を保証するのが推奨されます。

miseのインストール方法を教えてください

macOSではbrew install mise、Linuxではcurl https://mise.run | sh でインストールできます。インストール後、eval "$(mise activate zsh)" を.zshrcに追記してシェル統合を有効化します。詳細は公式サイト mise.jdx.dev を参照してください。

関連ツール

uv コマンド一覧asdfコマンド一覧Dockerコマンド一覧Gitコマンド一覧