@animaapp/cli 0.5.0 → 0.5.1

package/README.md

@@ -21,11 +21,11 @@ directly.
 > `api.agentgrid.io`.
 
 ```bash
-npx @animaapp/cli login
-npx @animaapp/cli create -t p2c -p "SaaS dashboard with sidebar and analytics"
+npx @animaapp/cli@latest login
+npx @animaapp/cli@latest create -t p2c -p "SaaS dashboard with sidebar and analytics"
 ```
 
-> Examples use `npx @animaapp/cli <command>`. If you install the package globally
+> Examples use `npx @animaapp/cli@latest <command>`. If you install the package globally
 > (`npm i -g @animaapp/cli`), the same commands are available as `anima <command>` —
 > the shorthand used in prose below.
 
@@ -51,7 +51,7 @@ identity (renewal is just logging in again).
 **Interactive agent (Claude Code, Cursor, a dev at a terminal):**
 
 ```bash
-npx @animaapp/cli login
+npx @animaapp/cli@latest login
 ```
 
 In a terminal it also tries to open the verification page for you (disable with
@@ -62,7 +62,7 @@ and relay the verification step. The CLI emits a `verification_required` event t
 **stderr** so your agent can surface it to its human while stdout stays clean:
 
 ```bash
-npx @animaapp/cli login --json
+npx @animaapp/cli@latest login --json
 # stderr:
 # {"event":"verification_required","verificationUri":"https://.../device",
 #  "verificationUriComplete":"https://.../device?user_code=ABCD-1234",
@@ -101,20 +101,20 @@ Resolution priority: `ANIMA_API_TOKEN` env var → stored credentials file → e
 
 ```bash
 # 1. Connect (once)
-npx @animaapp/cli login
+npx @animaapp/cli@latest login
 
 # 2. Create from a prompt / URL / Figma
-npx @animaapp/cli create -t p2c -p "E-commerce product page with cart"
-npx @animaapp/cli create -t l2c -u https://linear.app
-npx @animaapp/cli create -t f2c --file-key <key> --nodes 42:15
+npx @animaapp/cli@latest create -t p2c -p "E-commerce product page with cart"
+npx @animaapp/cli@latest create -t l2c -u https://linear.app
+npx @animaapp/cli@latest create -t f2c --file-key <key> --nodes 42:15
 
 # 3. Or bring YOUR OWN code: import it in one step -> publish
-npx @animaapp/cli create -t import --from ./my-project
-npx @animaapp/cli publish <sessionId>
+npx @animaapp/cli@latest create -t import --from ./my-project
+npx @animaapp/cli@latest publish <sessionId>
 
 # ...or start empty and push over git
-npx @animaapp/cli create -t empty --framework react --name "My project"
-npx @animaapp/cli get-git-token <sessionId>   # then: git clone <url>, add code, git push
+npx @animaapp/cli@latest create -t empty --framework react --name "My project"
+npx @animaapp/cli@latest get-git-token <sessionId>   # then: git clone <url>, add code, git push
 ```
 
 ---
@@ -124,11 +124,11 @@ npx @animaapp/cli get-git-token <sessionId>   # then: git clone <url>, add code,
 ### `login` — connect this machine
 
 ```bash
-npx @animaapp/cli login
-npx @animaapp/cli login --client-name "My CI Agent"   # label on the consent screen
-npx @animaapp/cli login --no-open                      # don't auto-open the browser
-npx @animaapp/cli login --print-mcp-config             # also emit an MCP server config
-npx @animaapp/cli login --invite <url-or-code>         # redeem a pre-approved invite — no approval step
+npx @animaapp/cli@latest login
+npx @animaapp/cli@latest login --client-name "My CI Agent"   # label on the consent screen
+npx @animaapp/cli@latest login --no-open                      # don't auto-open the browser
+npx @animaapp/cli@latest login --print-mcp-config             # also emit an MCP server config
+npx @animaapp/cli@latest login --invite <url-or-code>         # redeem a pre-approved invite — no approval step
 ```
 
 | Option | Description | Default |
@@ -141,7 +141,7 @@ npx @animaapp/cli login --invite <url-or-code>         # redeem a pre-approved i
 ### `mcp-config` — print your MCP server config (no new login)
 
 ```bash
-npx @animaapp/cli mcp-config
+npx @animaapp/cli@latest mcp-config
 ```
 
 Prints a ready-to-paste remote MCP server entry (points at `/v1/mcp` with a
@@ -158,11 +158,11 @@ by `mcp-config` and `--print-mcp-config`.
 ### `create` — a playground for your code, or AI-generated
 
 ```bash
-npx @animaapp/cli create -t import --from ./my-project              # import YOUR code (instant)
-npx @animaapp/cli create -t empty --framework react --name "My project"  # empty repo you push to (instant)
-npx @animaapp/cli create -t p2c -p "Analytics dashboard with a sidebar"
-npx @animaapp/cli create -t l2c -u https://stripe.com
-npx @animaapp/cli create -t f2c --file-key <key> --nodes 42:15
+npx @animaapp/cli@latest create -t import --from ./my-project              # import YOUR code (instant)
+npx @animaapp/cli@latest create -t empty --framework react --name "My project"  # empty repo you push to (instant)
+npx @animaapp/cli@latest create -t p2c -p "Analytics dashboard with a sidebar"
+npx @animaapp/cli@latest create -t l2c -u https://stripe.com
+npx @animaapp/cli@latest create -t f2c --file-key <key> --nodes 42:15
 ```
 
 `-t import` is the one-step upload path: your folder (or .zip) becomes the
@@ -194,7 +194,7 @@ returns a clear error for unsupported combinations.
 ### `codegen` — Figma to local files (no playground)
 
 ```bash
-npx @animaapp/cli codegen --file-key <key-or-url> --nodes 42:15 -o ./components
+npx @animaapp/cli@latest codegen --file-key <key-or-url> --nodes 42:15 -o ./components
 ```
 
 | Option | Values | Default |
@@ -216,8 +216,8 @@ doesn't need it — the playground is already visible at its `playgroundUrl`.
 otherwise share the playground URL and offer publishing as a follow-up.
 
 ```bash
-npx @animaapp/cli publish <sessionId>
-npx @animaapp/cli publish <sessionId> --mode designSystem --package-name my-ds
+npx @animaapp/cli@latest publish <sessionId>
+npx @animaapp/cli@latest publish <sessionId> --mode designSystem --package-name my-ds
 ```
 
 | Option | Values | Default |
@@ -229,7 +229,7 @@ npx @animaapp/cli publish <sessionId> --mode designSystem --package-name my-ds
 ### `unpublish` — take a published playground offline
 
 ```bash
-npx @animaapp/cli unpublish <sessionId>
+npx @animaapp/cli@latest unpublish <sessionId>
 ```
 
 The inverse of `publish`: clears the live URL so the deployed site stops being
@@ -239,9 +239,9 @@ again reuses the same subdomain.
 ### `update` — rename or change visibility (metadata only)
 
 ```bash
-npx @animaapp/cli update <sessionId> --name "New name"
-npx @animaapp/cli update <sessionId> --privacy public    # anyone with the link
-npx @animaapp/cli update <sessionId> --privacy private   # team only
+npx @animaapp/cli@latest update <sessionId> --name "New name"
+npx @animaapp/cli@latest update <sessionId> --privacy public    # anyone with the link
+npx @animaapp/cli@latest update <sessionId> --privacy private   # team only
 ```
 
 Never touches code or content — that's the git flow (`get-git-token`).
@@ -249,7 +249,7 @@ Never touches code or content — that's the git flow (`get-git-token`).
 ### `get-git-token` — read/edit a playground's code over git
 
 ```bash
-npx @animaapp/cli get-git-token https://dev.animaapp.com/chat/<sessionId>
+npx @animaapp/cli@latest get-git-token https://dev.animaapp.com/chat/<sessionId>
 ```
 
 A playground **is** a git repository, and git is the only way to read or edit
@@ -269,7 +269,7 @@ secret, and re-mint rather than store it.
 ### `logout` — disconnect this machine
 
 ```bash
-npx @animaapp/cli logout
+npx @animaapp/cli@latest logout
 ```
 
 A full local reset: clears **all** stored credentials (AgentGrid token, Figma
@@ -286,10 +286,10 @@ Note: `logout` removes this file too (full machine reset); `login --invite`
 writes `api-url` automatically from the invite URL's origin.
 
 ```bash
-npx @animaapp/cli config set api-url http://localhost:3789
-npx @animaapp/cli config get api-url
-npx @animaapp/cli config list
-npx @animaapp/cli config unset api-url
+npx @animaapp/cli@latest config set api-url http://localhost:3789
+npx @animaapp/cli@latest config get api-url
+npx @animaapp/cli@latest config list
+npx @animaapp/cli@latest config unset api-url
 ```
 
 The API URL resolves in this order: **`--api-url` flag → `ANIMA_API_URL` env →
@@ -298,9 +298,9 @@ The API URL resolves in this order: **`--api-url` flag → `ANIMA_API_URL` env
 ### `auth` — inspect or manage credentials
 
 ```bash
-npx @animaapp/cli auth --status            # token type + expiry
-npx @animaapp/cli auth --figma-token <T>   # save a Figma token for codegen / f2c
-npx @animaapp/cli auth --logout            # alias for `anima logout`
+npx @animaapp/cli@latest auth --status            # token type + expiry
+npx @animaapp/cli@latest auth --figma-token <T>   # save a Figma token for codegen / f2c
+npx @animaapp/cli@latest auth --logout            # alias for `anima logout`
 ```
 
 ---
@@ -334,7 +334,7 @@ default. Set it once with `config` instead of passing `--api-url` every time.
   a clean, parseable result.
 
 ```bash
-npx @animaapp/cli create -t p2c -p "dashboard" --json 2>/dev/null | jq .playgroundUrl
+npx @animaapp/cli@latest create -t p2c -p "dashboard" --json 2>/dev/null | jq .playgroundUrl
 ```
 
 ---
@@ -346,7 +346,7 @@ HTTP requests/responses, MCP connect and tool calls, and errors — to a file yo
 can inspect or share. Tokens and auth headers are redacted.
 
 ```bash
-npx @animaapp/cli login --log-file ./anima-debug.log
+npx @animaapp/cli@latest login --log-file ./anima-debug.log
 ```
 
 **`HTTP 404` on `login`** means the API at `--api-url` doesn't have the device

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animaapp/cli",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Generate production-ready apps from prompts, URLs, or Figma designs",
   "type": "module",
   "bin": {