AIesthetic CLI

Generate cinematic visual assets from your terminal.

Install

npm install -g aiesthetic-cli

Or use directly:

npx aiesthetic-cli generate "landing page for an e-scooter"

Quick Start

# 1. Login with your API key (from console.aiesthetic.in)
aiesthetic login

# 2. Generate your first asset
aiesthetic generate "Design a landing page for a luxury watch" --style cinematic

# 3. Check your account
aiesthetic status

Commands

aiesthetic login

Authenticate with your API key.

aiesthetic login
# or
aiesthetic login --key aie_live_xxx
# or set env var
export AIESTHETIC_API_KEY=aie_live_xxx

aiesthetic generate <prompt>

Generate a visual asset. Downloads 360 frames + README + animation prompt.

aiesthetic generate "coffee shop landing page"
aiesthetic generate "e-scooter product page" --style dramatic
aiesthetic generate "AI chip website" --feature asset  # includes transparent frames
aiesthetic generate "luxury watch" --scaffold nextjs   # scaffolds Next.js project
aiesthetic generate "furniture store" --no-download    # skip downloading, just print ID

aiesthetic pull <assetId>

Download a previously generated asset.

aiesthetic pull abc123
aiesthetic pull abc123 --only frames
aiesthetic pull abc123 --only transparent
aiesthetic pull abc123 --scaffold nextjs

aiesthetic projects list

List all your projects.

aiesthetic projects list
aiesthetic projects list --type api

aiesthetic assets list

List your generated assets.

aiesthetic assets list
aiesthetic assets list --feature generate-background
aiesthetic assets list --status completed --limit 10

aiesthetic assets delete <assetId>

Delete an asset.

aiesthetic assets delete abc123
aiesthetic assets delete abc123 --force

aiesthetic status

Check account status and credits.

aiesthetic status

Environment Variables

AIESTHETIC_API_KEY=aie_live_xxx   # API key (overrides stored config)

Config File

Stored at ~/.aiesthetic/config.json

Output Structure

After generate or pull, your output directory contains:

aiesthetic-assets/{requestId}/
├── frames/
│   ├── frame_0001.jpg
│   └── ... (360 total)
├── transparent-frames/     (only with --feature asset)
│   ├── frame_0001.png
│   └── ... (360 total)
├── README.md
├── animation-prompt.txt
└── asset-info.json