---
title: "alis completion"
url: "https://docs.alisx.com/reference/cli/completion/"
---
# alis completion

Generate the shell autocompletion script for `alis`.

## Synopsis

```bash
alis completion bash [flags]
alis completion fish [flags]
alis completion powershell [flags]
alis completion zsh [flags]
```

## Description

Each subcommand prints a completion script for one shell. Load it in the current session or install it so every new session has it; a new shell is needed for the installed script to take effect.

## Subcommands

### alis completion bash

Depends on the `bash-completion` package.

```bash
source <(alis completion bash)                                          # current session
alis completion bash > /etc/bash_completion.d/alis                      # Linux, every session
alis completion bash > $(brew --prefix)/etc/bash_completion.d/alis      # macOS, every session
```

### alis completion fish

```bash
alis completion fish | source                                           # current session
alis completion fish > ~/.config/fish/completions/alis.fish             # every session
```

### alis completion powershell

```powershell
alis completion powershell | Out-String | Invoke-Expression            # current session
```

For every session, add the output of that command to your PowerShell profile.

### alis completion zsh

If completion is not yet enabled, run once: `echo "autoload -U compinit; compinit" >> ~/.zshrc`.

```bash
source <(alis completion zsh)                                           # current session
alis completion zsh > "${fpath[1]}/_alis"                               # Linux, every session
alis completion zsh > $(brew --prefix)/share/zsh/site-functions/_alis   # macOS, every session
```

## Flags

| Flag | Type | Default | Meaning |
|---|---|---|---|
| `--no-descriptions` | bool | false | Disable completion descriptions (all four shells). |

Plus the [global flags](https://docs.alisx.com/reference/cli/index.md#global-flags).

## Notes

On Windows, the PowerShell installer adds completions to your profile unless run with `-NoCompletions`.