Usage Examples
Basic — show version and help
$ scorpiox-init --version
scorpiox-init 1.0.0
$ scorpiox-init --help
Run as container init — PID 1 inside a ScorpioX container
$ scorpiox-unshare -- scorpiox-init /bin/sh
scorpiox-init: loading tools from /usr/local/scorpiox/bin
scorpiox-init: 36 tools available
scorpiox-init: exec /bin/sh
Verbose mode — debug tool discovery
$ scorpiox-init --verbose -- scorpiox-bash
scorpiox-init: [debug] setting up mount namespace
scorpiox-init: [debug] bind-mounting /opt/scorpiox/tools → /usr/local/bin
scorpiox-init: [debug] scanning /usr/local/bin for scorpiox-* binaries
scorpiox-init: [debug] found: scorpiox-bash scorpiox-search scorpiox-edit ...
scorpiox-init: [debug] loading 12 requested tools
scorpiox-init: [debug] exec scorpiox-bash
$
Use inside Podman with selective tool loading
$ podman run --init-binary=/usr/bin/scorpiox-init \
scorpiox/code:latest scorpiox-search "hello world"
scorpiox-init: loading tools from /usr/local/scorpiox/bin
scorpiox-init: exec scorpiox-search "hello world"
[search results appear here]
Minimal rootless container session
$ scorpiox-unshare --map-root-user -- scorpiox-init -v -- sx chat "explain this code"
scorpiox-init: [debug] mapped uid 1000 → 0 in user namespace
scorpiox-init: [debug] scanning tools...
scorpiox-init: [debug] exec sx chat "explain this code"
[AI response appears here]