drafted
v1.14.26
Published
Drafted — visual thinking surface for humans and AI agents. Renders HTML, markdown, images, and code as frames on a zoomable canvas, with MCP tools for AI agents and real-time sync for humans.
Maintainers
Readme
Drafted
Multi-tenant shared surface for AI-human collaboration. Drafted organizes agent-produced work into projects (frames on a zoomable real-time surface), skills (reusable operating procedures agents load), and a wiki (durable org knowledge) — with MCP tools for agents and a browser UI for humans.
- Product vision and positioning: PRODUCT.md
- Architecture, development, and operations: AGENTS.md
- Live: drafted.live
OKF-native
Drafted is a native producer and consumer of the Open Knowledge Format (OKF) v0.1 (GoogleCloudPlatform/knowledge-catalog):
- The org wiki is an OKF v0.1 bundle. Every page carries conformant YAML frontmatter (required
type, one-linedescription,tags, synthesizedtimestamp; unknown keys preserved).index.mdat every level is synthesized,log.mdkeeps the date-grouped change history, links resolve with or without.md, and broken links are legal. The wiki UI shows a live OKF conformance badge. - Bundle exchange everywhere. Export/import the wiki (
GET /api/wiki/export.tar.gz,POST /api/wiki/import), the skill library (skills/<slug>/SKILL.mdlayout), and whole projects (<layer>/<lane>/<file>.mdconcepts; markdown links round-trip as connectors) — via HTTP or the MCPwiki,skill, andprojecttools, with dry-run reports.
Install
Claude Code, Codex, or any MCP client — installs the MCP server, the Drafted skill, and the eight slash commands (into ~/.claude/commands/drafted/ and ~/.codex/prompts/drafted/):
curl -fsSL https://drafted.live/install.sh | bash # macOS / Linux
irm https://drafted.live/install.ps1 | iex # WindowsAdding the MCP server on its own (e.g.
claude mcp add) gives you the tools without the skill or the commands.
Claude on the web (claude.ai) and Cowork — install the plugin, not the bare connector. The plugin bundles the Drafted connector plus the Drafted skill and the eight slash commands (/drafted:onboard-drafted, /drafted:create-project, /drafted:create-skill, /drafted:ingest, /drafted:extract, /drafted:improve-wiki, /drafted:improve-skill, /drafted:improve-project-harness); adding the connector URL on its own gives you the tools with none of the guidance.
- Settings → Customize plugins → Add → Add marketplace →
https://github.com/ddfourtwo/drafted-web→ install Drafted.- Settings → Connectors → find Drafted → Connect, then approve the sign-in.
Both halves matter: the plugin carries the skill and commands, the connector carries the tools. Installing the plugin does not sign you in to the connector.
Quick start (developing Drafted itself)
npm install && npm run dev # Docker services + schema + server with hot reload- App: http://localhost:3477
- Email inbox (magic links): http://localhost:8025
- MinIO console: http://localhost:9001
Sign in with any email and grab the magic link from Mailpit.
