<!-- @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`

**Effect**: modifies state

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.

### `--force`

**Effect**: modifies state

Replace a file at the target path that mise did not write

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
```
