|
| 1 | +# OpenKnowledge |
| 2 | + |
| 3 | +> Local-first AI markdown wiki — agent-written codebase docs in plain markdown. |
| 4 | +
|
| 5 | +| | | |
| 6 | +| ----------- | ---------------------------------------------------------------------------------- | |
| 7 | +| **Website** | [openknowledge.ai](https://openknowledge.ai) | |
| 8 | +| **GitHub** | [github.com/inkeep/open-knowledge](https://github.com/inkeep/open-knowledge) | |
| 9 | +| **By** | Inkeep | |
| 10 | +| **Tagline** | "Local-first AI markdown wiki" | |
| 11 | +| **Type** | Local-first markdown editor + AI agent runner | |
| 12 | +| **Pricing** | See [openknowledge.ai](https://openknowledge.ai) (product tiers vary by plan) | |
| 13 | +| **License** | GPL | |
| 14 | + |
| 15 | +--- |
| 16 | + |
| 17 | +## What It Does |
| 18 | + |
| 19 | +OpenKnowledge is a local-first markdown wiki from Inkeep. It stores knowledge as plain markdown files synced via git, runs AI agents against that corpus, and integrates with Claude, Codex, Cursor, and MCP-based agentic search. Version 0.18.0 (June 25, 2026) added a `codebase-wiki` starter pack that scaffolds a `wiki/` folder and an overview hub, then has an agent fill in architecture notes, module descriptions, data flows, and Mermaid diagrams. |
| 20 | + |
| 21 | +### Key Features |
| 22 | + |
| 23 | +- **Local-first storage** — Plain markdown files, private by default, synced through git |
| 24 | +- **codebase-wiki starter pack (v0.18.0)** — Scaffolds `wiki/` and an overview hub for agent-written codebase documentation |
| 25 | +- **Agent integrations** — Claude, Codex, Cursor, and MCP-based agentic search |
| 26 | +- **Architecture output** — Module pages, data-flow notes, and Mermaid diagrams as first-class wiki content |
| 27 | +- **Wiki-native workflow** — Optimized for knowledge capture and codebase understanding, not shipping features |
| 28 | + |
| 29 | +--- |
| 30 | + |
| 31 | +## How Shep Compares |
| 32 | + |
| 33 | +| | OpenKnowledge | Shep | |
| 34 | +| --------------------- | -------------------------------------- | ---------------------------------- | |
| 35 | +| **Focus area** | AI wiki / codebase knowledge base | Full SDLC lifecycle orchestration | |
| 36 | +| **Primary output** | Markdown wiki pages in `wiki/` | PRD, plan, code, tests, merged PR | |
| 37 | +| **Requirements** | Implicit in wiki structure | AI-generated PRD with approval gate | |
| 38 | +| **Planning** | Architecture / module documentation | Structured implementation plan | |
| 39 | +| **Execution** | Agent fills documentation pages | Agent implements in isolated worktrees | |
| 40 | +| **Lifecycle scope** | Knowledge & docs adjacent | Idea → requirements → merge | |
| 41 | +| **Dashboard** | Wiki editor experience | Interactive web graph + CLI | |
| 42 | + |
| 43 | +### What We Respect |
| 44 | + |
| 45 | +OpenKnowledge treats agent-written codebase documentation as a first-class product surface, not an afterthought. The v0.18.0 `codebase-wiki` flow — scaffold a `wiki/` tree, then let an agent populate architecture and data-flow pages — is a clean pattern for teams that need living docs before they need a full delivery pipeline. |
| 46 | + |
| 47 | +### Where Shep Differs |
| 48 | + |
| 49 | +OpenKnowledge is adjacent, not a direct SDLC competitor. It excels when the job is "help me understand and document this codebase in markdown." Shep excels when the job is "take this feature from idea through requirements, implementation, CI, and merge." The wiki angle complements lifecycle orchestration; they solve different handoffs. |
| 50 | + |
| 51 | +--- |
| 52 | + |
| 53 | +_Sources: [OpenKnowledge homepage](https://openknowledge.ai), [GitHub — inkeep/open-knowledge](https://github.com/inkeep/open-knowledge), [v0.18.0 release](https://github.com/inkeep/open-knowledge/releases/tag/v0.18.0)_ |
0 commit comments