Exit Codes

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

kapsl jq '.ok' data.json && echo "valid"
kapsl 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 kapsl error (image pull failure, config error, etc.)

Shell completion

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

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

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

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

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