vix completion generates a shell completion script for the Vix CLI.

Use it when you want your shell to autocomplete Vix commands.

vix completion
vix completion bash

Both commands generate Bash completion.

vix completion prints a shell completion script to standard output.

You can either load it for the current terminal session or save it to a file and source it from your shell configuration.

The generated completion script currently supports:

• top-level Vix commands
• vix help <command> completion
• Bash completion through the complete builtin

The documented target is:

vix completion bash

Calling vix completion without a shell also generates Bash completion.

Generate and load completion for the current shell session:

vix completion bash > ~/.vix-completion.bash
source ~/.vix-completion.bash

Then try:

vix <Tab>

You should see available Vix commands.

Use this when you only want completion for the current terminal session:

source <(vix completion bash)

This is temporary.

When you close the terminal, the completion is gone.

Use this to enable Vix completion every time you open a Bash terminal:

vix completion bash > ~/.vix-completion.bash
echo 'source ~/.vix-completion.bash' >> ~/.bashrc
source ~/.bashrc

After that, open a new terminal and try:

vix <Tab>

If you want to avoid adding the same line several times to ~/.bashrc, use:

vix completion bash > ~/.vix-completion.bash

grep -qxF 'source ~/.vix-completion.bash' ~/.bashrc || \
  echo 'source ~/.vix-completion.bash' >> ~/.bashrc

source ~/.bashrc

If you want to install completion for all users on a Linux system, you can write it to the Bash completion directory:

vix completion bash | sudo tee /etc/bash_completion.d/vix > /dev/null

Then start a new shell.

This requires Bash completion support to be installed on the system.

The completion script is generated from the commands registered in the Vix CLI.

After upgrading Vix, regenerate the completion file:

vix upgrade
vix completion bash > ~/.vix-completion.bash
source ~/.bashrc

This makes sure newly added commands can appear in completion.

The generated Bash script defines a _vix_completions function.

At the first command position, it completes available Vix commands:

vix <Tab>

It also completes command names after vix help:

vix help <Tab>

The command list is collected from the Vix command dispatcher at generation time.

That means the generated file reflects the installed Vix binary that produced it.

The current completion implementation focuses on top-level commands.

It does not yet complete every option of every subcommand.

For example, it can help with:

vix bu<Tab>
vix he<Tab>
vix help bu<Tab>

But it does not yet provide deep option completion such as:

vix build --pr<Tab>
vix run --sa<Tab>
vix registry sy<Tab>

Those can be added later when command-specific completion metadata is available.

# Print Bash completion script
vix completion bash

# Save completion script
vix completion bash > ~/.vix-completion.bash

# Load completion in current shell
source ~/.vix-completion.bash

# Install persistent completion
vix completion bash > ~/.vix-completion.bash
echo 'source ~/.vix-completion.bash' >> ~/.bashrc
source ~/.bashrc

# Regenerate after upgrading Vix
vix upgrade
vix completion bash > ~/.vix-completion.bash
source ~/.bashrc

This only writes the script:

vix completion bash > ~/.vix-completion.bash

You still need to load it:

source ~/.vix-completion.bash

This only works for the current terminal:

source <(vix completion bash)

For persistent completion, add it to ~/.bashrc:

echo 'source ~/.vix-completion.bash' >> ~/.bashrc

If you upgrade Vix and new commands were added, regenerate the completion file:

vix completion bash > ~/.vix-completion.bash

This is supported:

vix completion bash

This is not supported yet:

vix completion zsh
vix completion fish
vix completion powershell

Unsupported shells return an error.

First, confirm that the completion file exists:

ls ~/.vix-completion.bash

Then source it again:

source ~/.vix-completion.bash

Try completion:

vix <Tab>

On some Linux systems, Bash completion support may not be loaded by default.

Install it using your system package manager.

Ubuntu or Debian:

sudo apt install bash-completion

Then restart your terminal.

Regenerate it:

vix completion bash > ~/.vix-completion.bash
source ~/.bashrc

Return to the command overview.

Open all CLI commands