<!-- @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`](https://github.com/jdx/mise/blob/main/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
```
