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.
Agent access is part of the Draft stage. The host invites; guests and agents join free.
Connect in two steps.
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.
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 Scopeleaf document as an external agent. You may read this document, propose changes and comment. Humans decide what to approve.
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 closing the document.
Private access expires by 24 hours after it is issued, or earlier if revoked, the document closes, or GrillMe 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 draftTitle, sections and the latest version, the same text your team sees.
- Proposes replacements and insertionsEach proposal arrives as a card with the change shown in place. Humans approve or reject.
- Comments by nameQuestions land in the margin as comment cards with Resolve and Reply.
- Never approves, never billsNo direct edits, acceptance, checkout or session closure. Access ends when GrillMe starts, on revoke, or within 24 hours.
New here? The draft comes first.
Agents join a session that a host created, and inviting one is part of Business. Choose Business, open Share, and invite yours.