CLI Reference¶

Complete command reference for LooK v2.0.

Commands Overview¶

look demo <url>¶

Description: Generate a polished website demo video with AI analysis, cursor tracking, zoom effects, and voiceover.

Usage:

look demo <url> [options]

Example:

look demo https://myapp.com -o output.mp4 -d 30 -v nova

Options¶

Output & Duration¶

Voice & Style¶

Export¶

Zoom Behavior¶

Zoom Modes Explained: - none - No zoom, static view - basic - Simple zoom on clicks - smart - Intelligent zoom based on activity (recommended) - follow - Camera follows cursor continuously

Cursor Appearance¶

Cursor Styles: - default - Standard arrow - arrow-modern - Clean modern arrow - pointer - Hand pointer - dot - Simple dot - circle - Circular cursor - crosshair - Precision crosshair - spotlight - Spotlight effect - none - No cursor

Cursor Presets: - light, dark - Light/dark themes - blue, green, red, purple, orange - Colors - github, figma, notion - Brand-inspired

Click Effects¶

Click Effect Types: - ripple - Expanding ripple (default) - pulse - Pulsing circle - ring - Expanding ring - spotlight - Spotlight flash - none - No effect

Control Flags¶

Intelligent Pipeline Options¶

Story Arc Templates: - auto - AI selects best arc - problem-solution - Pain → Discovery → Solution → Results - feature-showcase - Feature 1 → Feature 2 → Feature 3 - journey - Start → Explore → Achieve → Delight - before-after - Before state → Process → After state - quick-demo - Hook → Core value → CTA

Pacing Styles: - relaxed - 0.7x speed, for tutorials - standard - 1.0x speed, general use - dynamic - 1.3x speed, feature showcases - energetic - 1.5x speed, social media

Video Enhancement Options¶

look quick <url>¶

Description: Quick demo with sensible defaults. Just works!

Usage:

look quick <url> [options]

Example:

look quick https://stripe.com

Options¶

Defaults Applied: - Preset: youtube - Zoom mode: smart - Max zoom: 1.6 - Style: professional

look mobile <app>¶

Description: Generate mobile app demos using Appium for device automation.

Usage:

look mobile <app> [options]

Example:

look mobile ./MyApp.app --platform ios --device "iPhone 15 Pro"
look mobile ./app.apk --platform android --device "Pixel 7"

Prerequisites¶

1. Appium server running:

   npm install -g appium
   appium --port 4723
   

2. Platform drivers:

   appium driver install xcuitest    # iOS
   appium driver install uiautomator2  # Android
   

3. Simulator/Emulator configured in Xcode or Android Studio

Options¶

look repo <url>¶

Description: Generate terminal demo from GitHub repository. Uses VHS for terminal recording.

Usage:

look repo <url> [options]

Example:

look repo https://github.com/user/awesome-cli

Options¶

look serve¶

Description: Start the LooK web editor UI for visual editing.

Usage:

look serve [options]

Example:

look serve -p 8080

Options¶

Web Editor Features¶

When you run look serve, the web editor provides:

• Visual Recording - Enter a URL and click Generate Demo or Live Record
• Templates - Pre-configured demo settings for SaaS, E-commerce, Mobile, etc.
• Settings Panel - Configure API keys directly in the browser
• Live Preview - Real-time preview during live recording
• Timeline Editor - Edit markers, zoom, and effects visually
• Script Editor - Edit AI-generated voiceover scripts
• Export Options - Export for YouTube, Twitter, Instagram, TikTok

First-Time Setup¶

1. Run look serve
2. Complete the onboarding tour
3. Click Settings → API Keys
4. Enter your OpenAI API key
5. Start creating demos!

Keyboard Shortcuts¶

Press Shift + ? in the editor to see all shortcuts:

look edit [projectId]¶

Description: Open an existing project in the web editor.

Usage:

look edit [projectId] [options]

Example:

look edit abc12345

Options¶

look projects¶

Description: List all saved projects.

Usage:

look projects

Output:

Saved Projects:

  abc12345 - Stripe Demo (1/15/2024)
  def67890 - My App (1/14/2024)

look test¶

Description: Verify installation and dependencies.

Usage:

look test [options]

Options¶

Output:

  FFmpeg installed: ✓
  Sharp working: ✓
  Playwright browser: ✓
  OpenAI API key: ✓

✅ All basic tests passed!

look mobile-test¶

Description: Check mobile recording prerequisites.

Usage:

look mobile-test [options]

Options¶

look devices¶

Description: List supported device frames for mobile demos.

Usage:

look devices

Output:

Supported Device Frames:

iOS:
  - iPhone 15 Pro Max (1290×2796)
  - iPhone 15 Pro (1179×2556)
  - iPhone 15 (1179×2556)
  - iPhone SE (750×1334)
  - iPad Pro 12.9" (2048×2732)
  - iPad Pro 11" (1668×2388)

Android:
  - Pixel 8 Pro (1344×2992)
  - Pixel 8 (1080×2400)
  - Samsung Galaxy S24 Ultra (1440×3120)
  - Samsung Galaxy S24 (1080×2340)

look batch¶

Description: Process multiple demos from a configuration file.

Usage:

look batch --config <path> [options]

Example:

look batch --config demos.yaml
look batch --config demos.json --concurrency 2

Options¶

Configuration Format¶

YAML Example:

defaults:
  duration: 30
  voice: nova
  preset: youtube

jobs:
  - url: https://app1.com
    output: demos/app1.mp4

  - url: https://app2.com
    output: demos/app2.mp4
    duration: 45
    voice: alloy

  - url: https://app3.com
    output: demos/app3.mp4
    preset: twitter

JSON Example:

{
  "defaults": {
    "duration": 30,
    "voice": "nova"
  },
  "jobs": [
    {"url": "https://app1.com", "output": "demos/app1.mp4"},
    {"url": "https://app2.com", "output": "demos/app2.mp4"}
  ]
}

Environment Variables¶

Exit Codes¶

look gif <input>¶

Description: Convert video to high-quality GIF with palette optimization.

Usage:

look gif <input> [options]

Examples:

# Basic GIF export
look gif video.mp4 -o output.gif

# Optimized for smaller size
look gif video.mp4 --width 480 --fps 10 --quality low -o output.gif

# Extract specific section
look gif video.mp4 --start 5 --end 15 -o clip.gif

Options¶

Quality Presets¶

look thumbnail <input>¶

Description: Generate video thumbnail with auto-selection or manual timestamp.

Usage:

look thumbnail <input> [options]

Examples:

# Auto-select best frame
look thumbnail video.mp4 --auto --preset youtube -o thumb.png

# Manual timestamp
look thumbnail video.mp4 --timestamp 12.5 -o thumb.png

# With title overlay
look thumbnail video.mp4 --auto --title "My Product Demo" -o thumb.png

Options¶

Platform Presets¶

look overlay <input>¶

Description: Apply professional overlays to video (lower thirds, captions, transitions).

Usage:

look overlay <input> [options]

Examples:

# Add lower third
look overlay video.mp4 \
  --lower-third "John Smith:Product Designer" \
  --lower-third-style modern \
  -o output.mp4

# Add scene transitions
look overlay video.mp4 \
  --transition blur \
  --transition-duration 0.5 \
  -o output.mp4

# Apply captions
look overlay video.mp4 \
  --captions subtitles.srt \
  --captions-style karaoke \
  -o output.mp4

Options¶

look captions <input>¶

Description: Generate animated captions from video audio or SRT file.

Usage:

look captions <input> [options]

Examples:

# Generate captions from video audio
look captions video.mp4 --output captions.srt

# Apply karaoke-style captions
look captions video.mp4 --style karaoke --apply output.mp4

# Apply pop-in word animation
look captions video.mp4 --style pop --apply output.mp4

Options¶

Caption Styles¶

Examples¶

# Quick demo
look quick https://myapp.com

# Custom output with specific duration
look demo https://myapp.com -o product-demo.mp4 -d 45

# Twitter-optimized short clip
look demo https://myapp.com -d 15 -p twitter -s energetic

# Silent demo with custom cursor
look demo https://myapp.com --skip-voice --cursor dot --cursor-color "#FF5500"

# Maximum zoom follow-cam
look demo https://myapp.com --zoom-mode follow --zoom-intensity 0.8 --max-zoom 2.5

# Mobile app demo
look mobile ./MyApp.app --platform ios --device "iPhone 15 Pro" --device-frame

# Preview script before recording
look demo https://myapp.com --dry-run

# Full control mode
look demo https://myapp.com \
  -o demo.mp4 \
  -d 30 \
  -v nova \
  -s professional \
  -p youtube \
  --zoom-mode smart \
  --cursor arrow-modern \
  --cursor-glow \
  --click-effect ripple \
  --click-color "#3B82F6"