> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# devbox completion

> Generate shell completion scripts for the Devbox CLI.

Use `devbox completion` to generate completion scripts for Bash, fish, PowerShell, or Zsh. Source the generated script in the current shell or install it for future sessions.

<h2 id="completion-usage">
  Usage
</h2>

```bash theme={null}
devbox completion [command]
```

## `devbox completion bash`

Generate a Bash completion script. This script requires the `bash-completion` package.

<h3 id="bash-usage">
  Usage
</h3>

```bash theme={null}
devbox completion bash [flags]
```

### Enable completion in the current Bash session

```bash theme={null}
source <(devbox completion bash)
```

### Install Bash completion on macOS

```bash theme={null}
devbox completion bash > $(brew --prefix)/etc/bash_completion.d/devbox
```

Start a new shell after installing the script.

<h3 id="bash-options">
  Options
</h3>

<ResponseField name="--no-descriptions" type="boolean">
  Omit descriptions from completion suggestions.
</ResponseField>

***

## `devbox completion fish`

Generate a fish completion script.

<h3 id="fish-usage">
  Usage
</h3>

```bash theme={null}
devbox completion fish [flags]
```

### Enable completion in the current fish session

```bash theme={null}
devbox completion fish | source
```

### Install fish completion

```bash theme={null}
devbox completion fish > ~/.config/fish/completions/devbox.fish
```

Start a new shell after installing the script.

<h3 id="fish-options">
  Options
</h3>

<ResponseField name="--no-descriptions" type="boolean">
  Omit descriptions from completion suggestions.
</ResponseField>

***

## `devbox completion powershell`

Generate a PowerShell completion script.

<h3 id="powershell-usage">
  Usage
</h3>

```bash theme={null}
devbox completion powershell [flags]
```

### Enable completion in the current PowerShell session

```powershell theme={null}
devbox completion powershell | Out-String | Invoke-Expression
```

Add this command to your PowerShell profile to enable completion in future sessions.

<h3 id="powershell-options">
  Options
</h3>

<ResponseField name="--no-descriptions" type="boolean">
  Omit descriptions from completion suggestions.
</ResponseField>

***

## `devbox completion zsh`

Generate a Zsh completion script. If shell completion is not enabled, initialize Zsh's completion system before loading the script.

<h3 id="zsh-usage">
  Usage
</h3>

```bash theme={null}
devbox completion zsh [flags]
```

### Enable completion in the current Zsh session

```bash theme={null}
source <(devbox completion zsh)
```

### Install Zsh completion on macOS

```bash theme={null}
devbox completion zsh > $(brew --prefix)/share/zsh/site-functions/_devbox
```

Start a new shell after installing the script.

<h3 id="zsh-options">
  Options
</h3>

<ResponseField name="--no-descriptions" type="boolean">
  Omit descriptions from completion suggestions.
</ResponseField>
