CLI Read Me

@cuppa-ai/cli

Build and manage your entire brand from the command line. The Cuppa CLI gives AI agents and power users direct access to every Cuppa feature.

Install

npm install -g @cuppa-ai/cli

Setup

# Authenticate with your API key
cuppa auth login

# Select your default brand
cuppa init

# Verify
cuppa status

Get your API key from Team Settings > API Keys.

Quick Start

# Generate an article with auto-grading
cuppa generate "best project management tools"

# Check GSC performance
cuppa performance --period 30d

# Optimize an underperforming article
cuppa optimize <article-id>

# Publish to CMS + social
cuppa publish <article-id> --platform ghost --social linkedin,twitter

# Full multi-asset campaign
cuppa campaign create --type mixed --images 5 --videos 3 --articles 2 --social instagram,linkedin --publish

# Bulk local SEO pages
cuppa seo local --service "roof repair" --locations cities.txt --research-serps

Commands

Workflow Commands

Command	Description
cuppa init	Interactive setup, select default brand
cuppa status	Brand dashboard overview
cuppa generate <keyword>	Create + poll + grade in one shot
cuppa optimize <id>	Grade + SERP research + optimize + re-grade
cuppa publish <id>	Publish to CMS + generate social posts
cuppa campaign create	Multi-asset campaign generation
cuppa performance	GSC keyword rankings snapshot
cuppa watch <id>	Poll generation status with live progress
cuppa seo local	Bulk local SEO service pages
cuppa seo programmatic	Programmatic pages from CSV + template
cuppa seo audit	SERP research + gap analysis

Resource Commands

auth meta content project site image social video preset knowledge cluster planner research links template agent mood-board brand chat page

Run cuppa <command> --help for details on any command.

Using with AI Agents

The CLI works with Claude Code, Cursor, and any AI assistant with terminal access. All commands support --format json for structured output:

cuppa content list --format json
cuppa performance --period 7d --format json

Your AI agent can compose primitives into any workflow. Research, generate, optimize, publish, and monitor, all from one terminal session.

Configuration

Config file: ~/.cuppa/config.json

Environment variables override config:

Variable	Description
CUPPA_API_KEY	API key
CUPPA_BASE_URL	API base URL
CUPPA_SITE_ID	Default site ID

Requirements

• Node.js 20+

• Cuppa account (Solo plan or above)

• API key from app.cuppa.ai

Links

• Documentation

• API Reference

• Cuppa AI

License

MIT