Collaborative docs for humans & agents

Create, share, and collaborate on documents with your AI agents. Self-hosted for private company data.

Create a document

How it works

1. Create a doc

Click "Create a document" or use the API. Your doc gets a shareable link.

2. Share with agents & humans

Paste the link into Claude Code, Codex, Cursor, or share with teammates.

3. Collaborate

Agents suggest edits and leave comments. You accept, reject, or reply. Every character tracks who wrote it.

Connect your agent

Point any AI agent at your self-hosted Proof instance — no install needed.

Create a document

The by field powers provenance tracking — the human sees exactly what your agent wrote.
Full docs: /agent-docs.

Set up your agent

Any Agent

Claude Code

Codex

Cursor

Windsurf

# Quick start: click "Create a document" above, then paste the doc URL into your agent.

export PROOF_BASE_URL="https://proof.util.cogb.us"

# Optional: install the Proof skill (if your agent supports skills)
# Skill URL: $PROOF_BASE_URL/proof.SKILL.md
# Claude Code:
#   mkdir -p ~/.claude/skills/proof && curl -fsSL "$PROOF_BASE_URL/proof.SKILL.md" -o ~/.claude/skills/proof/SKILL.md
# Codex:
#   mkdir -p ~/.codex/skills/proof && curl -fsSL "$PROOF_BASE_URL/proof.SKILL.md" -o ~/.codex/skills/proof/SKILL.md

# 1. Create a document (returns slug + token)

curl -sS -X POST "$PROOF_BASE_URL/documents" \
 -H "Content-Type: application/json" \
 -d '{"title":"My Doc","markdown":"# Hello\n\nFirst draft."}'

# Response includes: slug, accessToken
# Use these in the next steps.

# 2. Read it back

curl -H "Accept: application/json" \
  "$PROOF_BASE_URL/d/<slug>?token=<token>"

# 3. Suggest an edit (human accepts or rejects)

curl -sS -X POST "$PROOF_BASE_URL/documents/<slug>/ops" \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer <token>" \
 -d '{"type":"suggestion.add","kind":"replace","quote":"First draft.","content":"First draft, revised.","by":"ai:my-agent"}'

# "by" tracks provenance — set it to "ai:<your-agent-name>"

Read https://proof.util.cogb.us/agent-docs and follow the instructions to set up Proof for collaborative document editing. Our Proof instance is at https://proof.util.cogb.us

# Optional: install the Proof skill for persistent collaboration
mkdir -p ~/.claude/skills/proof && curl -fsSL "https://proof.util.cogb.us/proof.SKILL.md" -o ~/.claude/skills/proof/SKILL.md

Paste the first line into Claude Code. Optionally run the skill install command for persistent collaboration support.

Read https://proof.util.cogb.us/agent-docs and follow the instructions to set up Proof for collaborative document editing. Our Proof instance is at https://proof.util.cogb.us — save the Proof configuration to your codex agents config.

# Optional: install the Proof skill for persistent collaboration
mkdir -p ~/.codex/skills/proof && curl -fsSL "https://proof.util.cogb.us/proof.SKILL.md" -o ~/.codex/skills/proof/SKILL.md

Paste the first line into Codex. Optionally run the skill install command to save collaboration instructions to ~/.codex/.

Read https://proof.util.cogb.us/agent-docs and follow the instructions to set up Proof for collaborative document editing. Our Proof instance is at https://proof.util.cogb.us — save the Proof configuration to your cursor rules.

Paste this into Cursor. It will read the agent docs and configure itself for collaboration with this Proof instance.

Read https://proof.util.cogb.us/agent-docs and follow the instructions to set up Proof for collaborative document editing. Our Proof instance is at https://proof.util.cogb.us — save the Proof configuration to your windsurf rules.

Paste this into Windsurf. It will read the agent docs and configure Cascade for collaboration with this Proof instance.

Quick Reference

POST /documents

Create a new document

GET /d/:slug?token=...

View / read a document

POST /documents/:slug/ops

Comment, suggest, rewrite

POST /documents/:slug/edit/v2

Block-level edits

GET /documents/:slug/snapshot

Get block snapshot

GET /agent-docs

Full API documentation

Ready to start?

Create a document