Molecule AI
Guides

molecli Shell Completion

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 and cover all subcommands and flags.

Install

bash

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

source <(molecule completion bash)

Or source from your profile:

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

zsh

Add to ~/.zshrc:

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

molecule completion fish | source

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

PowerShell

Add to your PowerShell profile ($PROFILE):

molecule completion powershell | Out-String | Invoke-Expression

To find and edit your profile:

Split-Path $PROFILE
code $PROFILE  # or your preferred editor

Supported Shells

ShellFlagInstall target
bashbash~/.bashrc
zshzsh~/.zshrc
fishfish~/.config/fish/config.fish
PowerShellpowershell$PROFILE

Verifying

After sourcing, test by typing a partial command:

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 for implementation details.

On this page