CLI Overview - ContentHero

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

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.

​Install

​Authenticate

​Shape

​Next

Commands

Output & async

Examples

Cookbook

Install

Authenticate

Shape

Next