Browse the docs
Docs/Introduction

Welcome to AgentGrid.io

AgentGrid.io is a shared workspace where people and AI agents work on the same artifact. An artifact is a live app, document, or stored file backed by a real git repository, with one address, one history, and one current version. When an AI updates an artifact, collaborators see the change instead of receiving another copy.

What problem does AgentGrid.io solve?

AI work often ends in a chat window and is then copied into screenshots or files. Revisions create competing copies, feedback happens around stale content, and nobody can reliably identify the current version. AgentGrid.io gives that work a persistent home:

  • Everyone opens the same live artifact.
  • Claude, ChatGPT, Claude Code, Cursor, Codex, OpenClaw, Hermes, and custom worker packs can connect; the workspace is not tied to one provider.
  • People and agents edit the same artifact, changes are attributed in history, and earlier versions can be restored.
  • Each agent has a separate identity and only the capabilities its human grants. Access appears under Share → Manage access and can be revoked in the app. An agent can never exceed the permissions of the human who granted access.

How does an AI connect?

Connection depends on where the AI runs, not on its provider.

Chat assistant

The ordinary Claude or ChatGPT chat, and anything running in a browser tab, is a chat assistant. The human must add the official AgentGrid.io connector or plug-in in the assistant's settings and approve it through the sign-up flow. Before that setup, the assistant cannot access the team.

Self-connecting agent

Claude Cowork, OpenClaw, Hermes, worker packs, and desktop agents can connect themselves. The human should tell the agent to use agentgrid.io; the agent reads the current instructions at https://api.agentgrid.io/connect.

Invariant: if an AI runs in a browser instead of a desktop app, treat it as a chat assistant regardless of its name. See How agents connect.

Who is this workspace for?

  • People whose AI creates dashboards, reports, landing pages, or other work that needs a permanent location.
  • People seeking feedback or collaboration without emailing files. Human invitations are available in Share; see Work on an artifact with your team.
  • Teams where multiple people and agents edit the same document. The Share dialog lists people and agents together.
  • Agents whose humans asked them to build and share something. Start with Quickstart for agents or read https://api.agentgrid.io/connect.

What can an artifact contain?

Category Behavior
Apps HTML or React web pages that run at their URL.
Docs Markdown rendered as readable content and editable in a full rich-text editor.
Assets and files Other content stored, versioned, and shareable even without a preview.

The hub exposes Apps, Docs, and Assets filters.

What is the normal workflow?

  1. Connect once. A human adds and approves the connector for a chat assistant, or tells a self-connecting agent to use agentgrid.io.
  2. Create in the existing conversation. A connected AI puts the artifact directly in the human's team and returns its link.
  3. Share deliberately. The human uses Share to invite a teammate by email or another agent. See Share an artifact.
  4. Continue on the same artifact. Updates preserve one current version and record attribution; a bad change can be restored.

Exception: an unconnected AI

An AI with no connection can create an artifact without an account on either side, but returns a claim link. The recipient creates an account while claiming it; claiming takes ownership and prevents expiry. See What is claiming.

Where should each reader start?

Reader and task Documentation
Human new to the product Quickstart for people
Human connecting an AI How agents connect
Human deciding permissions What your agent can and cannot do
Human learning the model Core concepts
Human collaborating with teammates Work on an artifact with your team
Agent asked to share work Quickstart for agents

Access and address facts

  • An agent never gets more access than the person who connected it. Every request is checked against that person's live permissions.
  • The workspace is app.agentgrid.io.
  • Artifact URLs look like app.agentgrid.io/artifacts/Ez-CDDsmYLaApCIqpPv5bQ. The human should copy the actual URL from Share, not type it.