Exit Codes

boks passes through the exit code of the tool it runs, so it works in pipelines and scripts exactly like the native tool:

boks jq '.ok' data.json && echo "valid"
boks python test.py || exit 1

Codes

Code	Meaning
`0`	Success
`1–125`	Tool-specific exit code (passed through)
`126`	Command found but not executable
`127`	Command not found
non-zero	Container runtime or boks error (image pull failure, config error, etc.)

Shell completion

boks --completions <shell> prints a completion script for bash, zsh, fish, elvish, or powershell:

# zsh (any directory on your fpath)
boks --completions zsh > ~/.zfunc/_boks

# bash
boks --completions bash > ~/.local/share/bash-completion/completions/boks

# fish
boks --completions fish > ~/.config/fish/completions/boks.fish

Tools you have installed as shims complete normally through your shell's standard PATH completion, since they are ordinary executables on ~/.local/bin.