Skip to main content
smolvm completion sets up tab completion for the smolvm CLI. Once installed, your shell can complete subcommands, options, and the names of your existing sandboxes as you type — so smolvm sandbox ssh <Tab> offers the sandboxes you actually have. Supported shells are bash, zsh, and fish.

​
Synopsis

​
Arguments

​
string
required
Which shell to generate the completion script for. One of bash, zsh, or fish.

​
Options

​
flag
Install the completion script and wire it into your shell’s startup files. Without this flag, the script is printed to stdout so you can source it yourself.

​
One-shot install

The quickest path is to let SmolVM install completion for you:
Open a new shell afterward, then try:
What --install does per shell:
  • bash and zsh: write the completion script to ~/.smolvm/completions/ and add a single marker-tagged source line to your startup file (~/.bashrc, or ~/.bash_profile on macOS, or $ZDOTDIR/.zshrc). Re-running the command refreshes the script without duplicating the line.
  • fish: write the autoloaded completion file into ~/.config/fish/completions/smolvm.fish (honoring XDG_CONFIG_HOME). Fish picks it up automatically — no startup-file edit is needed.
If the install can’t write a file, smolvm prints a plain-English error naming the manual smolvm completion <shell> fallback below.
Running sudo smolvm completion <shell> --install still installs into the invoking user’s home directory (resolved via SUDO_USER), so completion lands where your interactive shell will actually see it.

​
Manual setup

Prefer to wire completion up yourself? Run the command without --install to print the script, then load it your own way:
Last modified on July 24, 2026