Atmee.aiDocs

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 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.

Commands by task

Account

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

Avatars

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

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)

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

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.

Everything else

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