CLI reference

The launcher ships as @klio-tech/klio on npm. Run it with npx — there is nothing to install globally.

npx @klio-tech/klio <command> [options]

Commands

command

Set up the local stack and wire your AI agents (Claude Code, Cursor, and any other supported client found on the machine).

npx @klio-tech/klio init [--cloud | --local] [--email <addr>] [--image-tag <tag>]

Flag	Effect
`--local`	Run the full stack locally; skip the hosted/local prompt
`--cloud`	Wire agents to Klio Cloud instead of a local stack
`--email <addr>`	Pre-fill the claim email
`--image-tag <tag>`	Pin a specific container image tag instead of the default

command

Show what is running, where, and as whom. The first thing to run when something looks wrong.

npx @klio-tech/klio status

command

Re-prompt for provider, curator and agent settings — or upgrade the stack to a new release.

npx @klio-tech/klio update [--check | --to-latest | --to-version <X>] [--watch]

Flag	Effect
`--check`	Report whether an upgrade is available; change nothing
`--to-latest`	Upgrade the stack to the newest release
`--to-version <X>`	Upgrade (or pin) to a specific version
`--watch`	Run a long-lived host-side process that applies background auto-updates the bridge has detected — avoids needing docker-in-docker

command

Tweak runtime settings such as auto-update mode and claim email.

npx @klio-tech/klio configure

command

Stop the stack. Data is preserved — this is the safe way to pause.

npx @klio-tech/klio down

command

Stop the stack, delete all data, and restore agent configs from the backups taken during init.

npx @klio-tech/klio uninstall

This deletes your memory store. Use down if you only want to stop the stack.

command

Print the package version.

npx @klio-tech/klio version
# or
npx @klio-tech/klio --version

Flag	Effect
`-h`, `--help`	Print usage
`-v`, `--version`	Print the package version