# CLI commands

> Install the Yalla CLI and learn the commands agents use most.

## Install

```bash
npm install -g @yalla/cli
```

## Core commands

- `yalla login` — start a browser-based session.
- `yalla deploy --env <name>` — deploy the current project.
- `yalla rollback --to <deployment-id>` — revert to a prior deployment.
- `yalla jobs watch` — stream provisioning job state.
- `yalla variables set <KEY>` — set a variable (values are prompted, never logged).

## Machine-readable output

Add `--json` to any command for a stable [Yalla envelope](/docs/api-envelopes). Agents should parse the envelope rather than scraping human text.

```bash
yalla deploy --env staging --json
```