Shell Completions

shellfirm can generate tab completion scripts for your shell, enabling autocomplete for commands, subcommands, and flags.

Generating completions

shellfirm completions <shell>

Replace <shell> with your shell name.

Setup by shell

Zsh

shellfirm completions zsh > ~/.shellfirm-completions.zsh
echo 'source ~/.shellfirm-completions.zsh' >> ~/.zshrc

Or place in your completions directory:

shellfirm completions zsh > "${fpath[1]}/_shellfirm"

Restart your shell or run source ~/.zshrc.

Bash

shellfirm completions bash > ~/.shellfirm-completions.bash
echo 'source ~/.shellfirm-completions.bash' >> ~/.bashrc

Or place in the system completions directory:

shellfirm completions bash > /etc/bash_completion.d/shellfirm

Restart your shell or run source ~/.bashrc.

Fish

shellfirm completions fish > ~/.config/fish/completions/shellfirm.fish

Fish automatically loads completions from this directory.

PowerShell

shellfirm completions powershell >> $PROFILE

Restart PowerShell to load the completions.

Elvish

shellfirm completions elvish >> ~/.config/elvish/rc.elv

Restart Elvish to load the completions.

What gets completed

Shell completions provide autocomplete for:

• Subcommands: shellfirm <TAB> shows init, config, check, policy, audit, status, mcp, wrap, completions
• Flags: shellfirm check --<TAB> shows --command, --test, --json
• Subcommand options: shellfirm init <TAB> shows --install, --uninstall, shell names

Verifying completions

After setting up completions, restart your shell and try:

shellfirm <TAB>

You should see the list of available subcommands.