GitHub - EveryInc/proof-sdk: Proof SDK: open-source collaborative editor, provenance model, and agent HTTP bridge

1 min read Original article ↗

Proof SDK is the open-source editor, collaboration server, provenance model, and agent HTTP bridge that power collaborative documents in Proof.

If you want the hosted product, use Proof. Hosted Proof is made by Every.

What Is Included

  • Collaborative markdown editor with provenance tracking
  • Comments, suggestions, and rewrite operations
  • Realtime collaboration server
  • Agent HTTP bridge for state, marks, edits, presence, and events
  • A small example app under apps/proof-example

Workspace Layout

  • packages/doc-core
  • packages/doc-editor
  • packages/doc-server
  • packages/doc-store-sqlite
  • packages/agent-bridge
  • apps/proof-example
  • server
  • src

Local Development

Requirements:

  • Node.js 18+

Install dependencies:

Start the editor:

Start the local server:

The default setup serves the editor on http://localhost:3000 and the API/server on http://localhost:4000.

Core Routes

Canonical Proof SDK routes:

  • POST /documents
  • GET /documents/:slug/state
  • GET /documents/:slug/snapshot
  • POST /documents/:slug/edit
  • POST /documents/:slug/edit/v2
  • POST /documents/:slug/ops
  • POST /documents/:slug/presence
  • GET /documents/:slug/events/pending
  • POST /documents/:slug/events/ack
  • GET /documents/:slug/bridge/state
  • GET /documents/:slug/bridge/marks
  • POST /documents/:slug/bridge/comments
  • POST /documents/:slug/bridge/suggestions
  • POST /documents/:slug/bridge/rewrite
  • POST /documents/:slug/bridge/presence

Compatibility aliases remain mounted for the hosted product, but the routes above are the public SDK surface.

Build

The build outputs the web bundle to dist/ and writes dist/web-artifact-manifest.json.

Tests

Docs

  • AGENT_CONTRACT.md
  • docs/agent-docs.md
  • docs/proof.SKILL.md
  • docs/adr/2026-03-proof-sdk-public-core.md

License

  • Code: MIT in LICENSE
  • Trademark guidance: TRADEMARKS.md