Introduction

Vatio is a runtime for customer-facing AI agents.

Define your agent in vatio.yml, connect the tools and knowledge it needs, and deploy it to web chat, WhatsApp, and Instagram. Vatio runs the conversations, verifies visitor identity, and gives your team an inbox to supervise replies.

Get started

Deploy your first agentInstall the CLI, write six lines of YAML, and talk to a live preview.Build with a coding agentPoint Claude Code, Codex or Cursor at Vatio over MCP and let it deploy.CLI referenceEvery vatio command, what it does, and which flags it takes.

You need Node.js 20 or newer and a Vatio account.

npm install -g @vatio-ai/cli@latest
vatio init acme
vatio push

Commands written as vatio assume a global CLI install. You can always replace that prefix with npx @vatio-ai/cli@latest.

Build

ManifestThe workspace contract: one vatio.yml, its root keys and what each one owns.ToolsGive the agent your API. One HTTP request, described in YAML.KnowledgeEntries you write and sites Vatio reads for you, re-read every night.AuthenticationYou sign a JWT saying who the visitor is; Vatio verifies it and never mints one.

Connect

Web widgetOne script tag, themed from the manifest or per page.WhatsAppTest on the shared number in a minute; connect your own for live traffic.InstagramAnswer DMs with the same agent, on a professional account.Browser SDKBuild your own chat UI against a dependency-free npm package.

For coding agents

This entire site is also one Markdown file: /docs.md, or vatio docs from the terminal. Every individual page is available as Markdown at its own path plus .md — /quickstart.md, for instance — so an agent can read the one page it needs rather than the whole contract. The index of them is /llms.txt.

vatio docs --save vatio-docs.md

That fetches the documentation from your configured Vatio host. Run it again to refresh the file; the CLI keeps no offline cache. To give an agent the commands themselves rather than the prose, connect the MCP server.

A starting prompt:

Read https://docs.vatio.ai/docs.md. Inspect this repository for an existing
vatio.yml before creating a workspace. Build a customer-facing agent
using the product's existing APIs and content. Deploy to preview, test
representative conversations, and show me the preview link and results.
Publish when I ask you to make it live.

For an existing workspace, work from the directory containing vatio.yml or one of its subdirectories, and preserve the existing workspace slug.

Release notes are in the changelog.