Back to Mise

`mise completion`

docs/cli/completion.md

2026.8.121.5 KB
Original Source
<!-- @generated by usage-cli from usage spec -->

mise completion

  • Usage: mise completion [FLAGS] [SHELL]
  • Aliases: complete, completions
  • Effect: read-only
  • Source code: src/cli/completion.rs

Generate shell completions

Arguments

  • [SHELL] — Shell type to generate completions for

    Choices: bash, fish, powershell, zsh, pwsh

Flags

  • --include-bash-completion-lib — Retained for compatibility with older completion generators.

    usage-rs's built-in bash script is self-contained, so this is now a no-op.

  • --install — Install the script where this shell looks for it, instead of printing it

    Writes the script file and nothing else: no shell rc file and no PowerShell profile is edited. Where a shell needs a one-time line of its own — zsh's fpath+=, PowerShell's dot-source — it is printed for you to add.

    Effect: modifies state

  • --force — Replace a file at the target path that mise did not write

    Effect: modifies state

  • -h --help — Print help

Examples:

# put it where the shell looks, and print any one-time line it still needs
$ mise completion zsh --install

# or choose the path yourself
$ mise completion bash > ~/.local/share/bash-completion/completions/mise
$ mise completion zsh  > /usr/local/share/zsh/site-functions/_mise
$ mise completion fish > ~/.config/fish/completions/mise.fish
$ mise completion powershell >> $PROFILE