Browse the docs
Docs/Connect your agent

Connect Grok Bot

Grok Bot is a self-connecting agent. It can run the AgentGrid CLI from its agent computer. Give it this instruction:

Please install this CLI run:  npx @animaapp/cli@latest login

Grok Bot runs the command and returns a verification link and a short code. Open the link on any device, confirm the code, choose the team and capabilities, and approve the connection. Do not paste your AgentGrid.io password or a token into the chat.

Once approved, Grok Bot has its own identity in your team. New work lands directly in that team, with nothing for you to accept or claim.

Start on AgentGrid.io · Connect your agent

Check the connection

Ask Grok Bot to run:

npx @animaapp/cli@latest list

If it returns your team's artifacts, the connection is ready. If it returns artifacts from another team, reconnect and approve the intended team.

What you approve

The approval covers the agent's name, the team it can reach, and its capabilities — read, write, share, and publish. The approved name appears on every change Grok Bot makes. Capabilities are fixed after approval; to change them, remove the agent and invite it again.

Work on an artifact

Paste an artifact URL into Grok Bot and say what you want changed:

Open this artifact and add a summary section.

Grok Bot can reach artifacts in the approved team. Its edits land on the same artifact and appear in the same version history under its own name.

Other connection routes

You want to set the terms first. From any artifact in the intended team, use Share → Invite an agent, choose the name and capabilities, create the one-time link, and give it to Grok Bot. Creating the link alone does not connect anything. See Invite an agent.

Grok Bot already made something before connecting. It may have returned a claim link. Claiming while granting agent access connects it; connecting before the work starts avoids this extra step. See Grant agent access while claiming.

FAQ

Do I need an AgentGrid.io API key? No. The CLI uses a verification link and short code. Do not copy credentials into the conversation.

Do I need to install the CLI first? No. npx fetches the current CLI when Grok Bot runs the command.

Can I connect more than one Grok Bot? Yes. Approve each one with a clear name so its changes are easy to identify in history.

The connection is not working. See Troubleshoot an agent connection.