2025-07-30

[MtkN1]

Today I Learned ...

[MtkN1]

mise で Autocompletion を構成する時の罠

Error: usage CLI not found. This is required for completions to work in mise.

$ mise^I
Error: usage CLI not found. This is required for completions to work in mise.
See https://usage.jdx.dev for more information.

原因: Autocompletion 時に usage コマンドが PATH にない。

• mise use -g usage を忘れている。
• mise activate bash の startup script が適用出来ていない。

これはドキュメントにしっかり要件として記載されている (https://mise.jdx.dev/installing-mise.html#autocompletion) 。 mise 環境に usage パッケージがあるだけでは不可。 コマンドが PATH にないといけない。

bash: command not found: _comp_initialize

$ mise^I
bash: command not found: _comp_initialize

原因: autocompletion script 生成時に usage パッケージが mise 環境にない。

• mise use -g usage の前に autocompletion script を生成した。

usage がないことで mise completion bash --include-bash-completion-lib は不完全な autocompletion script を生成する。 その為標記のエラーが発生する。 mise exec -- usge が実行出来る環境にあればよい。 コマンド自体は PATH になくてもよい。