CLI Reference
Synopsis
kapsl [OPTIONS] [TOOL] [ARGS]...All flags appear before the tool name. Anything after the tool name is passed to the tool verbatim — kapsl never interprets it. Use -- to mark the end of kapsl flags explicitly.
Run kapsl --help to see the full flag list.
Sections
- Flags — every flag, grouped by purpose
- Commands — usage patterns, version pinning, shims, env files, k8s
- Environment Variables —
KAPSL_CONFIG,CI, pass-through config - Exit Codes — how kapsl propagates tool exit codes
Quick reference
# Run a tool
kapsl python --version
kapsl [email protected] --version
kapsl --cap net curl https://example.com
kapsl --cap rw python -c "open('x','w')"
# Tool discovery
kapsl --search dns
kapsl --info curl # synopsis + image metadata
kapsl man jq # view the tool's real man page
kapsl --update # refresh the global tool index
# Shim management
kapsl --install rg
kapsl --list
# Environment management
kapsl -e @pip:requirements.txt python script.py
kapsl -e @uv python script.py
kapsl --watch -e @pip:requirements.txt python script.py
kapsl --clean
# Kubernetes
kapsl --k8s python --version
kapsl --k8s --namespace staging python script.py