Agents

Your agent, inside the shared draft.

Paste one invitation into Claude Code, Codex or Cursor. The agent reads the Draft, proposes changes and comments under its own name. Your team stays in control of what lands.

Start free previewTry the editor

Agent access is part of the Draft stage. The host invites; guests and agents join free.

Connect in two steps.

  1. 01

    Copy the invitation from Share

    In a Draft session the host opens Share → Your agent. The invitation is readable before you copy it; Copy issues a private credential for this session only.

  2. 02

    Paste it into your agent

    Claude Code, Codex, Cursor or any agent that can send HTTP requests connects by name. It appears in the header as “Shared with agents · 1 active” and in the activity feed.

What the invitation says

Join my Refinements Draft as an external agent. You may read this Draft, propose changes and comment. Humans decide what to accept.
Send separate JSON POST requests to https://<your-workspace>.convex.site/agents/v1
Headers: Content-Type: application/json; Authorization: Bearer <issued when you press Copy>
First: {"operation":"connect","name":"your agent name"}, then {"operation":"read"}.
Send {"operation":"heartbeat"} every 30 seconds while working.
Propose: {"operation":"propose","requestId":"a new UUID","version":THE_READ_VERSION,"proposals":[{"kind":"comment","anchor":"exact unique text from read","rationale":"your question"}]}.
For edits use kind "replace" or "insert_after" and include "replacement". At most 10 proposals per request. Preserve exact anchors. Re-read on stale_document. Reuse the same UUID and payload only for retries.
When done: {"operation":"disconnect"}. No direct edits, acceptance, billing or session closure.
Private access expires by 24 hours after it is issued, or earlier if revoked, the session closes, or Grill starts. Do not log or publish the token or document.

Example with a placeholder endpoint and credential. The real invitation is private to one session and expires within 24 hours.

What your agent can do with it.

  • Reads the current draft

    Title, sections and the latest version, the same text your team sees.

  • Proposes replacements and insertions

    Each proposal arrives as a card with the change shown in place. Humans accept or reject.

  • Comments by name

    Questions land in the margin as comment cards with Resolve and Reply.

  • Never accepts, never bills

    No direct edits, acceptance, checkout or session closure. Access ends when Grill starts, on revoke, or within 24 hours.

New here? The draft comes first.

Agents join a session that a host created. Start the free preview, open Share, and invite yours.

Start free preview