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

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 3 templates. Read the corresponding reference file before building the generate command.

Need	Template	Output	Cost	Reference
Single product image (main photo, banner, poster)	ecom-hero	IMAGE	1-2 cr/img	ecom-hero.md
Coordinated detail-page poster set	kv-image-set	IMAGE	1-2 cr/img × scenes	kv-image-set.md
Product listing copy (title, bullets, description)	listing	TEXT	1 cr	listing.md

Decision Tree

User wants visuals?
├── Single image → 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)

Product Type	ecom-hero style	kv-image-set style
Electronics, gadgets	tech	tech-future
Luxury, high-end	premium	magazine
Food, home goods	lifestyle	retro-film
Organic, eco-friendly	organic	organic-nature
Fashion, beauty	minimal	nordic-minimal
Kids, sports, bold	vibrant	cyberpunk
Artisan, handmade	studio	watercolor
Unsure / let AI decide	auto (default)	auto (default)

---

Typical Workflow

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

Commands Quick Reference

Command	Purpose
vibesku auth login|logout|status|refresh	Authentication management
vibesku init <api-key>	Initialize with API key
vibesku config set-key|set-url|show|reset	CLI configuration
vibesku templates [info <id>]	List / inspect templates
vibesku generate -t <id> [options]	Generate visuals or copy
vibesku refine <output-id> -p <prompt>	Refine output with edit instructions
vibesku status <job-id> [--watch]	Check job progress
vibesku jobs [-p <page>] [-t <template>]	List jobs
vibesku export <job-id> [-o <dir>]	Download outputs
vibesku batch <file> [--dry-run]	Bulk generation from JSON
vibesku credits [show|buy|redeem <code>]	Credit management

All commands support --json for machine-readable output. Full details: commands.md

Key Behaviors

• Asset upload: -i auto-uploads product images; -l uploads logo
• Modify vs Regenerate: Use vibesku refine <output-id> -p "<instruction>" to edit existing output. Use vibesku generate only for new creations.
• Full UUID required for refine: Use vibesku status <job-id> --json to get complete output UUIDs (table view truncates them).
• Agent-friendly output: Prefer --json flag for all commands when used by AI agents.
• Watch mode: --watch polls every 5s until all runs complete.
• Credit tracking: Generation and refine show remaining balance on success.

Environment Variables

Variable	Description
VIBESKU_API_KEY	API key (overrides config file)
VIBESKU_BASE_URL	Custom API URL (overrides config file)
NO_COLOR	Disable colored output