---
title: CLI overview
description: Current Sume CLI surface for the sume.com developer platform.
---

The Sume CLI is an agent-first wrapper over the current `api.sume.com/v1`
Developer API. It is intentionally separate from older consumer-product CLI
surfaces.

## Current status

The shipped CLI (`sumelabs/cli`) supports account verification, catalog
discovery, jobs, input assets, Avatar 1.0, Avatar Video 1.0, bundled agent
skills, schema discovery, and local diagnostics.

**Generation coverage is Avatar-heavy.** There are no first-class CLI
subcommands today for Image 1.0, Video 1.0, or Music 1.0. For those families,
call the [Developer API](/public-api) directly (see
[Image](/models/image), [Video](/models/video), [Music](/models/music)).

Local `sume mcp` is **not launched** in current CLI releases (`coming_soon`).
For remote MCP in Cursor/Claude, use the [hosted MCP](/mcp) connector at
`https://mcp.sume.com/mcp`.

Install the current native binary with the hosted installer:

```bash
curl https://cli.sume.com/install -fsS | bash
```

For Windows PowerShell:

```powershell
irm https://cli.sume.com/install.ps1 | iex
```

The installer resolves the latest `sumelabs/cli` GitHub Release, downloads the
matching platform binary, verifies `checksums.txt`, and installs `sume` under
`~/.sume-com/bin`.

Then sign in with the browser flow:

```bash
sume login
sume auth status
```

## API base

```text
https://api.sume.com/v1
```

## Common commands

```bash
sume login
sume auth status
sume account get
sume balance
sume usage get --limit 20
sume catalog list
sume jobs list
sume jobs status <job_id>
sume jobs result <job_id>
sume avatars create --confirm-paid --avatar-handle studio_presenter --type prompt --prompt "Friendly presenter"
sume avatar-videos create --confirm-paid --avatar-handle sume_clawra --script "Say hello" --quality plus
```

Use `--json` for stable machine-readable output and `--agent` when automation is
reading output that may contain sensitive URLs or account metadata.
Avatar-video scripts must estimate to 4-60 seconds inclusive.

## Next pages

1. [Install and update](/cli/install-login)
2. [Command reference](/cli/commands)
3. [Generation workflows](/cli/generation-workflows)
4. [Hosted MCP](/mcp) — remote connector (preferred over local `sume mcp` today)