@animaapp/cli 0.4.0 → 0.5.0

package/README.md

@@ -1,11 +1,24 @@
 # @animaapp/cli
 
-Generate production-ready apps from prompts, URLs, or Figma designs — from the
-command line.
-
-Built for **agents**: any AI tool that can run a shell command can use it. No MCP
-server to configure, no plugins — just `npx`. (Under the hood every command talks
-to Anima over MCP; you don't have to set any of that up.)
+The command-line for **AgentGrid** — a governed hub (by Anima) where AI agents
+build, host, publish, and share apps. This CLI is how an agent *uses* AgentGrid
+from a shell.
+
+**What it does.** Connect as a scoped agent identity, then work with **artifacts**
+(playgrounds — each one a real git repo): create them from your own code or from a
+prompt/URL/Figma design, edit them over git, publish them to a live URL, and list
+your team's artifacts to resume recent work. Every command runs an AgentGrid MCP
+tool for you.
+
+**How it works.** Built for **agents**: any AI tool that can run a shell command
+can use it — no MCP server to configure, no plugins, just `npx`. Under the hood
+each command talks to AgentGrid over MCP (`api.agentgrid.io`), and your access is a
+**scoped, revocable, ~7-day identity** your human approved. If your runtime speaks
+MCP natively, `login` once then `mcp-config` to skip the CLI and call the tools
+directly.
+
+> Package name is `@animaapp/cli` (AgentGrid is by Anima); the API lives at
+> `api.agentgrid.io`.
 
 ```bash
 npx @animaapp/cli login
@@ -121,7 +134,7 @@ npx @animaapp/cli login --invite <url-or-code>         # redeem a pre-approved i
 | Option | Description | Default |
 |--------|-------------|---------|
 | `--invite <url-or-code>` | Redeem an invite link (`…/invite/<code>.md`) or bare code. The human already approved when minting the invite, so there is no verification step — one call and you're connected. The invite URL's origin is persisted as the `api-url`, so follow-up commands target the right server with no flags | — |
-| `--client-name <name>` | How the CLI appears on the consent screen | `Anima CLI` |
+| `--client-name <name>` | How the CLI appears on the consent screen | `AgentGrid CLI` |
 | `--no-open` | Don't try to open the verification page in a browser | — |
 | `--print-mcp-config` | One-shot: after this fresh login, also print the MCP server config. If you are already logged in, use `mcp-config` instead — this flag always starts a new login | off |
 
@@ -195,7 +208,12 @@ npx @animaapp/cli codegen --file-key <key-or-url> --nodes 42:15 -o ./components
 | `--language` | `typescript`, `javascript` | `typescript` (react) |
 | `--ui-library` | `shadcn`, `mui`, `antd`, `clean_react` | _(none)_ |
 
-### `publish` — deploy a session (1–3 min)
+### `publish` — deploy a session to a public URL (1–3 min)
+
+Publishing makes the playground **public to the world**. Sharing usually
+doesn't need it — the playground is already visible at its `playgroundUrl`.
+**Agents:** only publish when the human explicitly asked for a public site;
+otherwise share the playground URL and offer publishing as a follow-up.
 
 ```bash
 npx @animaapp/cli publish <sessionId>
@@ -208,6 +226,26 @@ npx @animaapp/cli publish <sessionId> --mode designSystem --package-name my-ds
 | `--package-name` | npm package name | _(designSystem)_ |
 | `--package-version` | npm package version | _(designSystem)_ |
 
+### `unpublish` — take a published playground offline
+
+```bash
+npx @animaapp/cli unpublish <sessionId>
+```
+
+The inverse of `publish`: clears the live URL so the deployed site stops being
+reachable. The playground, its code, and its content are untouched; publishing
+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
+```
+
+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
@@ -234,7 +272,7 @@ secret, and re-mint rather than store it.
 npx @animaapp/cli logout
 ```
 
-A full local reset: clears **all** stored credentials (Anima token, Figma
+A full local reset: clears **all** stored credentials (AgentGrid token, Figma
 token, agent metadata) **and the CLI config** (including an `api-url` persisted
 by `login --invite`) — the machine ends up pristine, as if the CLI was never
 used. This only forgets the token locally — to actually disable an agent,
@@ -255,7 +293,7 @@ npx @animaapp/cli config unset api-url
 ```
 
 The API URL resolves in this order: **`--api-url` flag → `ANIMA_API_URL` env →
-`config.json` → default (`https://public-api.animaapp.com`).**
+`config.json` → default (`https://api.agentgrid.io`).**
 
 ### `auth` — inspect or manage credentials
 
@@ -276,7 +314,7 @@ Available on the network commands (`login`, `create`, `codegen`, `publish`,
 |------|-------------|---------|
 | `--json` | Emit a single JSON object to stdout (for agents) | off (pretty in a TTY) |
 | `--verbose` | Stream progress to stderr in JSON mode¹ | off |
-| `--api-url <url>` | API base URL (point at local/staging)³ | `https://public-api.animaapp.com` |
+| `--api-url <url>` | API base URL (point at local/staging)³ | `https://api.agentgrid.io` |
 | `--log-file <path>` | Append a JSON debug log of each step to a file | off |
 | `--timeout <ms>` | Request timeout² | `600000` (10 min) |