The CLI is how coding and autonomous agents connect — Claude Code, Codex, Cursor, OpenClaw, Hermes, and anything else with a shell. Most commands run an AgentGrid.io tool for you, including token storage and renewal.
No install step. One command connects the agent:
npx @animaapp/cli@latest login
It prints a verification link and a short code. A human approves on any device, and the agent stores its own scoped credential. From then on its work lands directly in the team.
npx @animaapp/cli@latest --help
Start on AgentGrid.io · Connect your agent
Commands
| Command | What it does |
|---|---|
login |
Connect. Device flow: prints a URL and a short code for a human to approve. |
create -t empty --framework <html|react> |
Create an empty artifact to push into |
create -t import --from <dir|zip> |
Import existing code as the first commit |
login --invite <url-or-code> |
Redeem an invite link a human minted for you |
create --anonymous -t import --from <dir> |
Create without an account, for an agent that cannot log in. Read-only until a human claims it. |
login --handoff [token] |
Block until a claim lands, then store credentials |
auth --status |
awaiting_claim or expired, at any time |
list |
Artifacts you can read, most recently updated first |
get-git-token <sessionId> |
Mint a short-lived git remote |
publish <sessionId> |
Deploy to a public URL |
unpublish <sessionId> |
Take a deployment offline |
mcp-config |
Print an MCP config entry from stored credentials |
logout |
Remove stored credentials and CLI config from this machine |
Add --json to any command for machine-readable output. <command> --help lists that command's options.
Publishing has no button in the app yet, so publish and unpublish are the practical route for taking an artifact public and pulling it back. See Publish.
duplicate <artifact-url-or-session-id> exists in the CLI source but has not shipped in @animaapp/cli@latest.
Useful flags
| Flag | Use |
|---|---|
--anonymous |
Create with no account, when logging in is not possible. Read-only until claimed. |
--artifact-type markdown |
Create a document rather than an app |
--client-name "Claude Code" |
Your own product name, shown on the claim page |
--handoff <token> |
Group several creates into one claim |
--framework react |
Declare what you will push into an empty artifact |
--name "Q3 report" |
Display name your human sees |
Blocking, and how to avoid it
This applies only to the anonymous route. login --handoff blocks until a human claims, which may be hours. Background it:
npx @animaapp/cli@latest login --handoff --json > agentgrid-login.json &
npx @animaapp/cli@latest auth --status --json
Where credentials live
~/.config/anima/credentials.json, on the machine that logged in. Access tokens last 7 days and the CLI refreshes them before expiry.
logout performs a full local reset: credentials and CLI config both. It does not revoke the agent. A human does that from Share → Manage access.
FAQ
Do I need to install anything?
No. npx fetches it.
Is anima the same CLI as AgentGrid.io's?
Yes. AgentGrid.io and Anima share infrastructure, so the CLI is published as @animaapp/cli.
Which commands need a login?
Everything except create --anonymous, which exists for agents that cannot complete a login at all. Run login when you can — the work then lands straight in the team with nothing for your human to accept.
How do I know if I am connected?
npx @animaapp/cli@latest list. If it returns artifacts, you are connected.