Skip to main content
The contenthero CLI drives everything from a shell. It is the right transport when you do not have MCP wired up but you have a terminal, and it is ideal for CI and scripts. It rides the same /api/v1 API as the SDK.

​
Install

npm install -g @contenthero/cli   # Node 20+, binary is `contenthero`
contenthero --version

​
Authenticate

contenthero login        # browser-assisted, provisions and stores a key
contenthero auth status  # exits 0 when authenticated
login opens a browser, provisions a key for this machine, and stores it at ~/.contenthero/credentials (mode 0600). The auth ladder is --api-key flag, then the CONTENTHERO_API_KEY environment variable, then the stored credential. The environment variable always wins over the stored file, so CI can override a local login: 
export CONTENTHERO_API_KEY=ch_live_...
Never paste your key into an agent chat. Use contenthero login or the environment variable. See API Keys.

​
Shape

The pattern is contenthero <noun> <verb>, with JSON on stdout by default. 
contenthero generate image --prompt "..." --model nano-banana-2
contenthero model list
contenthero account balance
contenthero brand-kit list
contenthero post list

​
Next

Commands

The full command tree by resource.

Output & async

JSON output, exit codes, cost preflight, and polling.

Examples

Practical recipes and scripting patterns.

Cookbook

End-to-end workflows.