# Quickstart

You need **Node.js 20 or newer** and a Vatio account. The examples use `acme`
as a workspace slug; replace it with yours.

## Install the CLI

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

## Create a workspace

Run these commands in the repository where you want to keep your agent:

```bash
mkdir support-agent
cd support-agent
vatio init acme
```

`init` creates the remote workspace and writes `vatio.yml` in the **current
directory**. It opens device authorization if you are not logged in. Complete
that step in your browser. If you already own the remote workspace, `init`
uses it.

## Define the agent

Replace the starter contents of `vatio.yml` with:

```yaml
workspace: acme
business:
  name: Acme
  summary: Acme sells warehouse robotics.
agent:
  name: Acme Support
  instructions: |
    Help visitors understand Acme's warehouse robotics.
    Ask what they need help with. If you do not have the information
    to answer, say so. Never invent product details or prices.
  personality: Warm, concise, and clear.
```

`workspace` selects the remote workspace. `agent.instructions` defines what
its single agent does. The other fields in this example are optional.

## Deploy and test

```bash
vatio push
vatio chat "What does Acme do?"
```

`push` validates your files and deploys to `preview`. Open the preview link it
prints, or continue the conversation with another `chat` command.

```bash
vatio chat "Can you tell me the price?"
vatio chat debug
vatio chat reset
```

Check that the agent answers from the supplied context and acknowledges what
it does not know. `debug` reads the current CLI chat; `reset` starts a new one.

## Publish

When the preview is ready for customers:

```bash
vatio publish
```

Your agent is now available at `https://vatio.ai/w/acme`.
`vatio rollback` restores the previous live deployment.

Next, [add knowledge](https://docs.vatio.ai/knowledge), [connect your API](https://docs.vatio.ai/tools), or
[embed the widget](https://docs.vatio.ai/channels/widget).