---
title: molecli Shell Completion
description: Enable tab completion for the molecli (molecule-cli) TUI dashboard in bash, zsh, fish, and PowerShell.
---

# molecli Shell Completion

The `molecule` CLI (`molecli`) supports shell completion for bash, zsh, fish, and PowerShell. Completion scripts are auto-generated by [Cobra](https://github.com/spf13/cobra) and cover all subcommands and flags.

## Install

### bash

Add to `~/.bashrc` or `~/.bash_completion.d/`:

```bash
source <(molecule completion bash)
```

Or source from your profile:

```bash
# In ~/.bash_profile or ~/.bashrc
[[ -f ~/.bash_completion ]] && source ~/.bash_completion
source <(molecule completion bash)
```

### zsh

Add to `~/.zshrc`:

```bash
autoload -U compinit && compinit
autoload -Uz bashcompinit && bashcompinit
source <(molecule completion zsh)
compdef _molecule molecule
```

Completion will activate automatically after restarting your shell or running `source ~/.zshrc`.

### fish

```fish
molecule completion fish | source
```

To persist across sessions, add the line above to `~/.config/fish/config.fish`.

### PowerShell

Add to your PowerShell profile (`$PROFILE`):

```powershell
molecule completion powershell | Out-String | Invoke-Expression
```

To find and edit your profile:
```powershell
Split-Path $PROFILE
code $PROFILE  # or your preferred editor
```

## Supported Shells

| Shell | Flag | Install target |
|-------|------|----------------|
| bash | `bash` | `~/.bashrc` |
| zsh | `zsh` | `~/.zshrc` |
| fish | `fish` | `~/.config/fish/config.fish` |
| PowerShell | `powershell` | `$PROFILE` |

## Verifying

After sourcing, test by typing a partial command:

```bash
molecule <TAB><TAB>
```

You should see available subcommands: `completion`, `workspace`, `config`, etc.

## Reference

```
molecule completion [bash|zsh|fish|powershell]
```

- `bash` — Bash completions (~/.bashrc)
- `zsh` — Zsh completions with compdef (~/.zshrc)
- `fish` — Fish shell completions (~/.config/fish/completions)
- `powershell` — PowerShell completions ($PROFILE)

See [`molecule-cli` PR #5](https://github.com/Molecule-AI/molecule-cli/pull/5) for implementation details.
