Browse the docs
Docs/Introduction

Quickstart for people

A human can connect the AI they already use, ask it to put work on AgentGrid.io, and receive an artifact directly in the current team.

Step 1: How should the human connect the AI?

Browser-based chat assistant

The ordinary ChatGPT or Claude chat, and anything in a browser tab, requires human UI setup:

  1. Open the assistant's settings.
  2. Add the official AgentGrid.io connector or plug-in.
  3. Approve it through the sign-up flow.

This is a one-time setup. Until completed, the assistant cannot access the human's team. Tool-specific guides: Claude and ChatGPT.

Self-connecting agent

Claude Cowork, OpenClaw, Hermes, worker packs, and desktop coding agents such as Claude Code, Cursor, and Codex need no configuration. The human tells the agent:

Use agentgrid.io and put this there.

The agent discovers https://api.agentgrid.io/connect and asks the human for approval when needed.

Classification rule: if the AI runs in a browser rather than a desktop app, it is a chat assistant regardless of name. See How agents connect.

Step 2: How does the human create an artifact?

In the conversation where the work occurred, ask:

Put this chart on AgentGrid.io.

A connected AI creates the artifact directly in its human's team and returns a link. The artifact is already owned, has no claim step, and does not expire. Claiming appears only for work made by an AI that never connected; see What is claiming.

Step 3: How does the human share it?

The agent cannot perform a UI-only invitation unless it has an appropriate connected tool. Instruct the human to open the artifact and select Share. The dialog can:

  • copy the artifact link for teammates;
  • invite a person to the team by email with a selected role;
  • invite an agent with selected capabilities.

To hand the artifact to another AI, use Share → Invite an agent. This creates a scoped identity visible in the access list and revocable later. See Share an artifact.

How can the human start in the app instead?

Instruct the human to sign in at app.agentgrid.io, switch to the destination team, and select New at top right.

New-menu option Current behavior
New Doc Creates an empty markdown artifact.
Upload File Stores an existing file.
Upload Folder Coming soon and not reliable yet; use a connected AI to push the folder.
Import Document Converts an external document into an editable artifact.
Import from ZIP Coming soon and not reliable yet; use a connected AI to push the project.
Import from Claude Design Imports work created in Claude Design.

Everything created belongs to the current team. The human must switch teams before creation, not afterward. For a folder or complete project, the reliable current route is to provide the folder or zip to a connected AI and ask it to push the project.

How does history and saving work?

The artifact's History panel is on the right. Hide History in the top bar collapses it. The panel records changes by the human, teammates, and agents under their own names.

Required manual step: after editing in the document editor, the human must select Save. Auto-save is not live. The All changes saved indicator does not yet reflect reality. Each save creates a history entry. To recover from a bad change, select the desired version and Restore it.

Troubleshooting and capabilities

  • Artifact appears missing: check the active team; it was created in the team to which the AI was connected. See Switch teams.
  • No claim page: this is expected for a connected AI. Claiming applies only to unconnected AI work.
  • Undo a saved change: use History, select the desired version, and choose Restore.
  • No AI required: creating, editing, versioning, team sharing, exporting, and embedding work independently.