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:

CLI token (vibesku auth login) — browser-based device flow, tokens at ~/.vibesku/config.json
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 5 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
Single technical exploded infographic	`exploded-view`	IMAGE	1-2 cr/img	exploded-view.md
Clean white-background packshot	`white-background`	IMAGE	1-2 cr/img	white-background.md
Product listing copy (title, bullets, description)	`listing`	TEXT	1 cr	listing.md

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
├── Marketplace/catalog white-background packshot → white-background
│   ├── Pure white background → backgroundTone: pure-white
│   ├── Softer depth → backgroundTone: soft-white
│   └── Tighter framing → cropMode: close-up
├── 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)

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

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

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.
Version drift check (recommended triggers): Compare local VERSION with upstream when any of these happen: unknown template/option error, template mismatch with vibesku templates --json, user asks for newly added capability, or local check is older than 7 days (recommended cadence). If issues occur during execution, prioritize this check before retrying generation/refine commands. Follow versioning.md.
Auto-update when outdated (recommended): If upstream version is newer, update skill first, then continue the user task with the updated skill.
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