VibeSKU CLI

Command-line interface for VibeSKU — AI-powered creative automation that turns product SKU photos into agency-grade e-commerce visuals and marketplace-ready copy in seconds.

What VibeSKU Does

VibeSKU replaces manual creative production for e-commerce teams. Upload a product photo, define brand guidelines, and receive complete multi-format visual sets. Core capabilities: VisionKV™ visual system (complete visual collections from a single product), high-fidelity product restoration (1:1 precision on textures/logos/packaging), multilingual text overlays, and omni-channel format output.

Credit costs: 1K/2K image = 1 credit, 4K image = 2 credits, short video = 5 credits, copy = 1 credit.

Setup

The CLI is bundled at bin/vibesku.js — self-contained Node.js script, zero dependencies (requires Node >= 18).

node <skill-dir>/bin/vibesku.js --help
alias vibesku="node <skill-dir>/bin/vibesku.js"   # optional

Skill Version

• Source of truth: VERSION
• Local version: cat VERSION
• Upstream repo: UllrAI/vibesku-agent

For version checks and auto-update workflow, see versioning.md.

Authentication

Two methods, resolved in priority order:

1. CLI token (vibesku auth login) — browser-based device flow, tokens at ~/.vibesku/config.json
2. API key — VIBESKU_API_KEY env var > config file key (from vibesku init or vibesku config set-key)

vibesku auth login                # Browser login (recommended)
vibesku init vsk_<key>            # API key for CI/CD

Template Selection Guide

VibeSKU provides 4 templates. Read the corresponding reference file before building the generate command.

Decision Tree

User wants visuals?
├── Technical exploded infographic → exploded-view
│   ├── Balanced callouts (default) → labelPlacement: balanced-callout
│   ├── Cleaner visual without labels → labelPlacement: none
│   └── Category-aware environment → backgroundMode: product-matched-scene
├── Single image (hero/banner/poster) → ecom-hero
│   ├── Product main photo → scenario: MAIN_IMAGE, aspectRatio: 1:1
│   ├── Marketing banner  → scenario: BANNER, aspectRatio: 16:9
│   └── Vertical poster   → scenario: POSTER, aspectRatio: 3:4
└── Multiple coordinated images → kv-image-set
    ├── Full detail page     → scenes: [kv-hero, lifestyle, detail-01, specs-table, ...]
    ├── Quick hero + lifestyle → scenes: [kv-hero, lifestyle]
    └── Brand storytelling   → scenes: [kv-hero, brand-story, user-review]

User wants text?
└── Product listing copy → listing
    ├── Amazon  → templateName: AMAZON_LISTING
    ├── Taobao  → templateName: TAOBAO_DETAIL
    ├── Shopify → templateName: SHOPIFY_DESC
    └── General → templateName: GENERIC

Quick Style Matching (image templates)

Typical Workflow

vibesku auth login                              # 1. Authenticate
vibesku templates                               # 2. Browse templates
vibesku templates info exploded-view            # 3. Inspect template details (optional)
vibesku credits                                 # 4. Check balance
vibesku generate -t ecom-hero \
  -n "Wireless Headphones" \
  -i product.jpg -l logo.png \
  -b "AudioTech"                                # 5. Generate visuals
vibesku status <job-id> --watch                 # 6. Monitor until complete
vibesku refine <output-uuid> -p "brighter bg"   # 7. Refine (optional)
vibesku export <job-id> -o ./output             # 8. Download results

Commands Quick Reference