# CLI

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

```bash
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:

```bash
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](https://vatio.ai/docs/quickstart) if you have not deployed an agent yet.

## Commands

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

## Using it

- [Configuration and uploads](https://vatio.ai/docs/cli/configuration) — Where credentials live, which env vars override them, what a push sends.