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

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:

Requirements

• Node.js 20+
• Cuppa account (Solo plan or above)
• API key from app.cuppa.ai

Links

• Documentation
• API Reference
• Cuppa AI

License

MIT