#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 account
init, login, doctor, docs, config.
Deployments
push, publish, rollback, status, diff.
Chats
chat, and chat show to read any chat back with its tool calls.
Flags, evals and tools
flags, eval and tools: what supervisors reported, how your tools' backend answered, and proving the fix.
Knowledge bases
kb: bases and the entries you write into them.
Business
business: name, description and opening hours, the same the inbox edits.
Secrets
secrets: the values tools read as $env.KEY.
Publishable tokens
tokens and the origins each accepts: what a page carries.
Server keys
keys: what your backend calls the server API with.
Templates and webhooks
templates and webhooks: what your backend needs to send WhatsApp messages.
Routines
routines: a Claude Code routine your agent hands work to, as a tool.
Channels
whatsapp and instagram point you at the inbox, where both are set up.
Authentication keys
auth --new-key: the keypair that signs a visitor's JWT.