braaand

CLI for Braaand — brand infrastructure for agentic automation.

Manage brands, assets, templates, projects, ad sets, and renders from the terminal. AI agents use the same tool via Claude Code skills.

Install

npm install -g braaand

Auth

braaand auth login     # Device auth flow (opens browser)
braaand whoami         # Who you're authed as + brand counts
braaand auth logout    # Remove stored credentials

Commands

Brands

braaand brands list
braaand brands get <id>
braaand brands config <id>                             # colors, fonts, voice, tokens
braaand brands info <id>                               # Full dump with asset URLs
braaand brands knowledge <id> [sectionId]
braaand brands portal <id>                             # Open brand portal in browser
braaand brands create <name> [--description <d>]
braaand brands update <id> [--name <n>] [--description <d>]
braaand brands delete <id> --yes --confirm-brand-id <id>

Assets

braaand assets list <brandId>
braaand assets get <brandId> <assetId> [--meta] [--output <path>]
braaand assets upload <brandId> <file> [--name <n>] [--type logo|image|font|icon|symbol|document]
braaand assets delete <brandId> <assetId>

Templates

braaand templates list <brandId>
braaand templates get <brandId> <templateId>
braaand templates discover <brandId>                   # Agent-facing catalog
braaand templates create <brandId> <name> [--from <file.json>]
braaand templates delete <brandId> <templateId> [--force]

System templates

braaand system-templates list
braaand system-templates instantiate <id> --brand <brandId>

Projects & ad sets

braaand projects list <brandId>
braaand projects create <brandId> <name> [--description <d>]
braaand projects update <brandId> <projectId> [--name <n>]
braaand projects delete <brandId> <projectId>

braaand adsets list <brandId> <projectId>
braaand adsets create <brandId> <projectId> <name> --ads @ads.json
braaand adsets update <brandId> <projectId> <adSetId> --ads @ads.json
braaand adsets delete <brandId> <projectId> <adSetId>

Rendering

# Single format
braaand render <brandId> <templateId> --format 1x1 --output hero.png

# Multiple formats (comma-separated)
braaand render <brandId> <templateId> --format 1x1,9x16,4x5 --output hero
# → writes hero-1x1.png, hero-9x16.png, hero-4x5.png

# All formats the template supports
braaand render <brandId> <templateId> --all-formats --output hero

# Batch render a saved ad set
braaand render batch <brandId> <projectId> <adSetId> --output-dir ./renders

Onboarding & sync

braaand onboard <file.json>                            # Create brand + config + assets
braaand sync [brandId] [--dir <path>]                  # Sync brand assets locally

Config

braaand config show                                    # Current API URL + auth state
braaand config set-url <url>                           # Default: https://www.braaand.ai

Output

All commands output JSON to stdout. Pipe to jq for filtering:

braaand brands list | jq '.[].name'
braaand assets list my-brand | jq '.[] | select(.type == "font") | .name'

More

See braaand.ai for full documentation.