derive-to/derive

View on GitHub ↗

Review and approval for work made by AI agents. Fair Source, self-hostable, and MCP-native.

23 ★2 forksTypeScriptUpdated 18d ago

What you need to know

Workspace for work made with agents — publish an HTML page, Markdown document, deck, or built site to a permanent, versioned live URL with comments and history, self-hostable as one container, and connectable to coding agents via a remote MCP server (OAuth) or a local stdio server.

Install

Try anonymous drafts without an account: curl -F file=@page.html https://derive.to/v1/drafts
npx skills add derive-to/derive --skill derive
claude mcp add --transport http derive https://derive.to/mcp
npm i -g @derive-to/cli

Usage

  • Install the skill if you have npm (npx skills add ...), otherwise read https://derive.to/skill.md and follow it (MCP server: https://derive.to/mcp).
  • Publish from the CLI: derive init my-doc --template slides, then derive publish from that directory.
  • Connect agents over remote MCP with OAuth: claude mcp add --transport http --scope project derive https://derive.to/mcp, or codex mcp add derive --url https://derive.to/mcp.
  • The agent acts at the role you grant: publish access publishes directly; a lower scope files a proposal a human approves.

Key features

  • Every revision is a new version at the same URL, so shared links keep resolving with their history.
  • Comments pin to exact text, direct edits create new versions, and formal review requests for sign-off.
  • Portable context — content, versions, and comments stay with each artifact so a teammate or another agent can continue the work.
  • Contexts let agents answer questions from connected data and publish cited results under the same access controls.
  • Sandboxed viewer on an opaque origin, flexible storage (SQLite/local disk or Postgres + S3/R2), live collaboration, share previews, and CLI + MCP.
  • Fair Source: run, modify, and self-host freely except offering it as a competing commercial product.

Best for

Teams and coding agents who want durable, shareable, continuously improvable artifacts (plans, reports, decks, sites) with versioning, comments, and agent access.

Caveats

  • Fair Source license (FSL-1.1-ALv2): self-hosting and modifying are free, but you cannot offer Derive itself as a competing commercial product (each release converts to Apache-2.0 two years after it ships).
  • Remote MCP is OAuth-based (hosted service); a local stdio server needs DERIVE_SERVER and optionally DERIVE_TOKEN.
  • Agent actions are role-limited — a lower scope files proposals for human approval instead of publishing.
Platforms: Local · Remote · WebClients: Claude Code · Codex · Cursor

Reviewed 2026-08-18

Topics

ai-agentsapproval-workflowartifact-managementcollaborationdocument-reviewfair-sourcemcp-servermodel-context-protocolself-hostedstatic-siteversion-control
Stars
23★
Forks
2
Language
TypeScript
License
NOASSERTION
Created
2026-06-11
Last push
2026-08-17