@animaapp/cli

CLI for generating production-ready apps from prompts, URLs, or Figma designs.

Works with any AI coding tool that can run shell commands — no MCP setup, no plugins, just npx.

Quick Start

# One-time: save your tokens
npx @animaapp/cli auth --token <anima-token>
npx @animaapp/cli auth --figma-token <figma-token>

# Create an app from a prompt
npx @animaapp/cli create -t p2c -p "SaaS dashboard with sidebar and analytics"

# Clone a website
npx @animaapp/cli create -t l2c -u https://stripe.com

# Convert Figma to code
npx @animaapp/cli codegen --file-key <figma-url> -o ./components

# Publish to a live URL
npx @animaapp/cli publish <sessionId>

Authentication

Get your Anima API token at dev.animaapp.com > Settings > API Keys.

# Store tokens (persisted to ~/.config/anima/credentials.json)
npx @animaapp/cli auth --token <anima-token>
npx @animaapp/cli auth --figma-token <figma-token>

# Or use environment variables
export ANIMA_API_TOKEN=<token>
export FIGMA_TOKEN=<token>

Priority: env var > stored credentials file.

Commands

create — Generate a playground (3-7 min)

# Prompt to Code
npx @animaapp/cli create -t p2c -p "E-commerce product page with cart"

# Link to Code (clone a website)
npx @animaapp/cli create -t l2c -u https://linear.app

# Figma to Code
npx @animaapp/cli create -t f2c --file-key <key> --nodes 42:15

Options (all optional with sensible defaults):

| Option | Values | Default | |--------|--------|---------| | --framework | react, html | react | | --styling | tailwind, css, plain_css, css_modules, inline_styles | tailwind | | --language | typescript, javascript | typescript (when react) | | --ui-library | shadcn, mui, antd, clean_react | (none) | | --guidelines | free text | (none, p2c only) |

publish — Deploy to live URL (1-3 min)

npx @animaapp/cli publish <sessionId>
npx @animaapp/cli publish <sessionId> --mode designSystem --package-name my-ds

codegen — Figma to local files

npx @animaapp/cli codegen --file-key <key-or-url> --nodes 42:15 -o ./components

Requires a Figma personal access token (stored via auth --figma-token or FIGMA_TOKEN env var).

download — Download playground project

npx @animaapp/cli download https://dev.animaapp.com/chat/<sessionId> -o ./my-project

auth — Manage credentials

npx @animaapp/cli auth --token <T>         # Save Anima token
npx @animaapp/cli auth --figma-token <T>   # Save Figma token
npx @animaapp/cli auth --status            # Check what's configured
npx @animaapp/cli auth --logout            # Clear all credentials

Output Modes

• Terminal (TTY): Colored text with spinner and progress
• Piped (AI tools): Single JSON object to stdout

# AI tool usage — parse JSON output
npx @animaapp/cli create -t p2c -p "dashboard" --json 2>/dev/null | jq .playgroundUrl

Progress is streamed to stderr with --verbose.

Timing

| Command | Duration | |---------|----------| | create | 3-7 minutes | | publish | 1-3 minutes | | codegen | 2-5 minutes | | download | seconds |

The --timeout default is 600,000ms (10 min). Do not reduce it.

Exit Codes

| Code | Meaning | |------|---------| | 0 | Success | | 1 | API error | | 2 | Auth error | | 3 | Validation error | | 4 | Timeout |

License

MIT