Completion Commands

Enable tab completion for bash, zsh, or fish shells.

Global options available on completion commands: --json, --no-color.

Supported Shells

Shell	Config File
bash	~/.bashrc
zsh	~/.zshrc
fish	~/.config/fish/config.fish

bb completion install

Install shell completions for your current shell.

bb completion install [options]

Options

Option	Description
--json	Output as JSON

The installer auto-detects your shell and adds the necessary configuration.

Post-Installation

After installing, restart your shell or source your config:

# Bash
source ~/.bashrc

# Zsh
source ~/.zshrc

# Fish
source ~/.config/fish/config.fish

Examples

# Install completions
bb completion install

# Install with JSON output
bb completion install --json

# Test it works
bb <Tab>        # Shows: auth, repo, pr, config, completion
bb repo <Tab>   # Shows: clone, create, list, view, delete

---

bb completion uninstall

Remove shell completions.

bb completion uninstall [options]

Options

Option	Description
--json	Output as JSON

Examples

# Remove completions
bb completion uninstall

# Remove completions with JSON output
bb completion uninstall --json

---

What Gets Completed

Tab completion works for:

• Commands: auth, repo, pr, config, completion
• Subcommands: login, clone, create, list, etc.
• Options: --json, --no-color, --workspace, --repo, --help

-w is reserved as the global shorthand for --workspace.

Example Session

$ bb pr<Tab>
pr

$ bb pr <Tab>
activity  approve   checks    checkout  comments  create    decline
diff      edit      list      merge     ready     reviewers view

$ bb pr create --<Tab>
--body                --close-source-branch  --destination
--draft               --help                 --repo
--source              --title                --workspace