Open Knowledge
An agent-native knowledge platform. OSS core, markdown in git, rich editing, AI co-creation.
Open Knowledge is an agent-native knowledge platform where humans and AI co-create, co-edit, and co-maintain knowledge.
Core principles
- Markdown files in git as the canonical substrate -- not a database, not a proprietary format.
- Agent-agnostic -- no LLM inference in the OSS core. All intelligence comes from external agents (Claude Code, Cowork, Cursor, Codex) via MCP tools.
- Everything branchable -- all meaningful state is files in git. Drafts, experiments, and proposals are branches. No separate state management.
- Rich editing -- Obsidian-grade WYSIWYG with source toggle, not a terminal-grade text editor.
- Local-first -- single-player IC to start, with CRDT architecture that gives a clear path to real-time collaboration.
Tech stack
| Layer | Technology | Role |
|---|---|---|
| Editor | TipTap v3 + ProseMirror | Rich WYSIWYG markdown editing |
| CRDT | Yjs v13 + y-prosemirror | Real-time sync, conflict-free concurrent editing |
| Collab server | Hocuspocus | WebSocket server, document management, persistence hooks |
| Source view | CodeMirror 6 | Raw markdown editing with syntax highlighting |
| Persistence | Git (plumbing commands) | Auto-commit to WIP refs, no "save" button |
| Agent interface | MCP server | Read/write/search knowledge via any AI agent |
Positioning
"Obsidian, but agent-native and collaborative."
The P0 audience is individual contributors -- developers and knowledge workers using Claude Code or Cowork -- who need a knowledge base their agent can reason over AND that they can edit with a rich experience.
Quick start
npx @inkeep/open-knowledge clone https://github.com/company/docs # Clone + start
npx @inkeep/open-knowledge init # Or: scaffold on an existing project
npx @inkeep/open-knowledge start # Hocuspocus collab; auto-spawns the editor at http://localhost:3000
npx @inkeep/open-knowledge preview # Show which files the watcher will trackclone is the fastest path from a GitHub URL to editing -- it clones the repo, scaffolds the project, and starts the editor. Changes sync with GitHub automatically. For existing local projects, use init + start instead.
After init, open your project in an MCP-compatible editor (Claude Code, Cursor, VS Code, or Windsurf) and approve the open-knowledge server. The agent can start working immediately — start is optional. When the agent calls its first MCP tool and no collab server is running, ok mcp detach-spawns ok start as a sibling process so resumption is zero-ceremony.
Documentation
Getting started
Clone a repo or initialize an existing project, start the editor, connect AI agents.
GitHub Sync
Clone repos, auto-sync with your team, and resolve conflicts.
Configuration
Config schema, YAML hierarchy, environment variables, CLI flags.
CLI reference
All commands: start, clone, auth, sync, push, pull, mcp, init, preview.
MCP integration
Disk-only vs connected mode, available tools, supported clients.
Open in Agent Desktop
One-click handoff from the editor to Claude Cowork, Claude Code, Codex, or Cursor.
Service topology
Per-project server architecture, persistence pipeline, shadow repo.