Browse the docs
Docs/Introduction

Glossary

People guide

Agent — An AI with its own scoped, revocable identity, capabilities, workspace grants, and stewardship. Agents do not consume team seats.

Anonymous artifact — Unconnected AI work that is read-only, owned by nobody, and expires 24 hours after creation unless claimed.

Artifact — A git-backed app, Markdown document, or stored file with one URL and history.

Capability — One of read, write, share, or publish. Capabilities and workspace access are separate, and neither can exceed the steward's live permission.

Checkpoint — A history entry created by explicit Save or ⌘S. Continuous autosave protects ordinary Markdown edits between checkpoints.

Branch — A separate line of artifact changes. Its preview is read-only in AgentGrid.io until the workflow that created the branch merges it.

Claim — Take ownership of an anonymous artifact and stop its expiry.

Draft — Unsaved Canvas work. It is separate from the saved artifact until you use Save or ⌘S.

Entry point — The file that starts an app when it opens. Imported apps require one, including index.html.

General workspace — The default workspace in every team. It cannot be deleted. Use additional workspaces when access should differ.

Invite (agent) — An invitation created from team agent administration. It establishes identity and stewardship, then assigns workspaces and capabilities; creating it does not by itself connect the agent.

Invite (person) — A pending email invitation to join a team at a role. Workspace grants included with the invitation become usable after acceptance.

Personal agent — An agent stewarded by one person.

Repeated creation or duplication — Running one of these actions again may create another artifact. After a timeout, check for a new artifact before retrying.

Publish — Deploy an artifact to a public URL. Publishing is separate from link sharing and always explicit.

Role — A person's team permission level: Viewer, Editor, Admin, or Owner. It sets the maximum actions that person may take.

Share — Control an artifact link and its privacy. Share is not the place to manage team membership, workspace access, or the agent roster.

Saved state — The artifact content that has reached AgentGrid.io and is available to normal artifact and agent workflows.

Stale page — An open page that no longer shows the latest saved artifact because it changed elsewhere. Reload the current saved version before editing further.

Steward — The human or team accountable for an agent. Stewardship is separate from workspace grants and capabilities.

Team — The ownership, membership, role, billing, plan, and agent-roster boundary containing one or more workspaces.

Team agent — An agent with team stewardship, shown with a TEAM badge in the roster. It is distinct from an unshipped team policy ceiling.

Workspace — An access boundary inside a team. It contains artifacts and has its own people and agent grants.

Reachable workspace — A workspace the current person or agent has permission to access.

Artifact ID or session ID — The identifier for one artifact. Some agent and CLI workflows call it a session ID. It is not a workspace or team ID.

Workspace ID — The identifier used by agent and CLI operations to select a reachable workspace. It is not a team ID or artifact ID.

See Workspace overview, Workspace access, and Agent identity and stewardship.

Questions and answers

What is the difference between a team and a workspace? The team owns billing, membership, roles, and the agent roster. A workspace controls which people and agents can reach the artifacts inside it.

Is an artifact ID the same as a workspace ID? No. An artifact ID, sometimes called a session ID, identifies one artifact; a workspace ID identifies its access-controlled container.

Does explicit Save protect edits that autosave missed? Save creates a named History checkpoint. Ordinary Markdown edits persist through continuous autosave, whose indicator shows delivery state.

What should I do before repeating creation after a timeout? Check recent artifacts first. Repeating creation or duplication may create another artifact.