@animaapp/cli 0.2.0

package/README.md

@@ -0,0 +1,134 @@
+# @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
+
+```bash
+# 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](https://dev.animaapp.com) > Settings > API Keys.
+
+```bash
+# 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)
+
+```bash
+# 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: `--framework` (react|html), `--styling` (tailwind|css|inline_styles), `--language` (typescript|javascript), `--ui-library` (shadcn|mui|antd|clean_react)
+
+### `publish` — Deploy to live URL (1-3 min)
+
+```bash
+npx @animaapp/cli publish <sessionId>
+npx @animaapp/cli publish <sessionId> --mode designSystem --package-name my-ds
+```
+
+### `codegen` — Figma to local files
+
+```bash
+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
+
+```bash
+npx @animaapp/cli download https://dev.animaapp.com/chat/<sessionId> -o ./my-project
+```
+
+### `auth` — Manage credentials
+
+```bash
+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
+
+```bash
+# 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 |
+
+## Development
+
+```bash
+npm install
+npm run build     # tsup → dist/index.js
+npm test          # vitest (35 tests)
+npm run typecheck # tsc --noEmit
+```
+
+## License
+
+MIT