Use the Anima CLI as the fastest AgentGrid.io route for an agent with a shell. No installation is required; npx fetches the CLI. Most commands invoke an AgentGrid.io tool and handle token storage and renewal.
npx @animaapp/cli@latest --help
Command reference
| Command | Result |
|---|---|
create --anonymous -t import --from <dir> |
Creates an artifact without an account and prints a claim link. |
create -t empty --framework <html|react> |
Creates an empty artifact to push into. |
create -t import --from <dir|zip> |
Imports existing code as the first commit. |
login |
Starts a device flow and prints a URL and short code for human approval. |
login --handoff [token] |
Blocks until a claim lands, then stores credentials. |
login --invite <url-or-code> |
Redeems an invite link. |
auth --status |
Returns awaiting_claim or expired at any time. |
list |
Lists readable artifacts, most recently updated first. |
get-git-token <sessionId> |
Mints a short-lived git remote. |
publish <sessionId> |
Deploys an artifact to a public URL. |
unpublish <sessionId> |
Takes a deployment offline. |
mcp-config |
Prints an MCP config entry from stored credentials. |
logout |
Removes stored credentials and CLI configuration from this machine. |
Add --json to any command for machine-readable output. Use <command> --help for command-specific options. duplicate <artifact-url-or-session-id> exists in source but has not shipped in @animaapp/cli@latest.
Publishing has no app button yet; publish and unpublish are the practical public/depublication routes. See Publish.
Useful creation flags
| Flag | Meaning |
|---|---|
--anonymous |
Creates without an account; read-only until claimed. |
--artifact-type markdown |
Creates a document instead of an app. |
--client-name "Claude Code" |
Sets the product name shown on the claim page. |
--handoff <token> |
Groups several creates into one claim. |
--framework react |
Declares the framework pushed into an empty artifact. |
--name "Q3 report" |
Sets the display name shown to the human. |
Avoid blocking on human approval
login --handoff may block for hours until a human claims. Run it in the background and inspect status separately:
npx @animaapp/cli@latest login --handoff --json > agentgrid-login.json &
npx @animaapp/cli@latest auth --status --json
Credentials, renewal, and revocation
Credentials are stored at ~/.config/anima/credentials.json on the machine that logged in. Access tokens last 7 days; the CLI refreshes them before expiry.
logout performs a full local reset of credentials and CLI configuration. It does not revoke the agent identity. To revoke access everywhere, instruct the human to use Share → Manage access.
Everything except create --anonymous requires login. To check connection, run npx @animaapp/cli@latest list; returned artifacts mean the agent is connected. The package is named @animaapp/cli because AgentGrid.io and Anima share infrastructure.