CLI

The npm package is @vatio-ai/cli; its installed executable is vatio. The rest of this reference uses that shorter form:

npm install -g @vatio-ai/cli@latest
vatio --help

Alternatively, replace vatio in any command with npx @vatio-ai/cli@latest. Specifying @latest explicitly requests the current release. Update a global install by running the install command again.

Authorize the machine once, and check what the CLI thinks it is talking to:

vatio login
vatio doctor

Every command below finds the nearest vatio.yml at or above the current directory and reads workspace from it. Start with the quickstart if you have not deployed an agent yet.

Commands

Workspace and accountinit, login, doctor, docs, config, issue.Deploymentstools check, push, publish, rollback, status, diff.Chatschat, and the transcript and debug views of it.Knowledge baseskb: bases, entries, and the sites that write them.Secretssecrets: the values tools read as $env.KEY.Publishable tokenstokens and widget: what a page carries.Channelswhatsapp and instagram, live and on the shared preview.Authentication keysauth --new-key: the keypair that signs a visitor's JWT.

Using it

Configuration and uploadsWhere credentials live, which env vars override them, what a push sends.MCP servervatio mcp exposes these same commands to a coding agent.