# CLI

URL: https://www.atmee.ai/docs/v2/cli

> The atmee command line: make and manage avatars, keys and sessions from a terminal or a script.

`atmee` does from a terminal what the [MCP server](/docs/v2/agents/mcp-server) does for an agent:
make and change avatars, pick v2 candidates, manage API keys and start sessions. Use it when you
would rather type commands or script them. Agents use it too: the `build-avatar-app` skill runs it
to create the project's API key.

Install it and sign in first: see [Install](/docs/v2/cli/install).

## Commands by task

**Account**

```bash
atmee account    # plan, limits, prices, v2 access
atmee balance    # credits left
```

**Avatars**

```bash
atmee avatars create --name "Clinic receptionist" --image portrait.jpg --voice voice.m4a --wait
atmee avatars list
atmee avatars get ID
atmee avatars update ID --greeting "Hi, welcome to Bright Smile Dental."
atmee avatars replace-appearance ID new-portrait.jpg
atmee avatars delete ID
```

**v2 candidates**

```bash
atmee avatars candidates pick ID      # compare takes side by side in the browser
atmee avatars candidates list ID
```

**API keys** (signed in as an owner or admin)

```bash
atmee keys create --name "website" --out .env   # the secret goes to the file, never the screen
atmee keys list
atmee keys revoke KEY_ID
```

**Sessions**

```bash
atmee avatars session chat ID --open   # start a conversation and open it in the browser
atmee avatars session render ID --livekit-url URL --livekit-token TOKEN   # Avatar mode, into your room
atmee avatars session status SESSION_ID
atmee avatars session end SESSION_ID
```

A conversation from `session chat` ends when you leave the room; `session status` and
`session end` are for render sessions started with `session render`.

Sessions are billed per minute, and generating portraits or voices costs credits. See
[pricing](https://www.atmee.ai/pricing).

## Everything else

Every command has `--help`, and `atmee --help` lists them all. `--json` gives machine-readable
output for scripts.