Why KiwiFS?
Markdown is the lingua franca of agents and developers — but raw.md files are just files. No search, no versioning, no structure. KiwiFS layers database-like guarantees on top of plain markdown:
- Files are the truth — every page is a plain markdown file with YAML frontmatter. No proprietary format, no lock-in.
- Agents already know the API —
cat,grep,echowork out of the box. No SDK needed. - Every write is a git commit — full history, blame, diff, and rollback for free.
- Full-text + vector search — BM25 via SQLite FTS5 out of the box, with pluggable vector embeddings.
- Query language (DQL) — SQL-like queries over frontmatter metadata.
- Web UI included — wiki links, knowledge graph, Mermaid diagrams, markdown editing, Bases, canvas, comments, and dark mode.
- Single binary, zero config — download and run. No Node, no Docker required (Docker optional).
How it works
All protocols flow through the same storage layer. Every write — regardless of how it enters — gets a git commit, a search index update, and an SSE broadcast.For AI agents
KiwiFS publishes machine-readable documentation for LLMs and agent frameworks:- llms.txt — concise overview with key endpoints and MCP tool names
- llms-full.txt — complete API + MCP + CLI reference in a single file
llms-full.txt to give it everything it needs to read, write, search, and manage a KiwiFS knowledge base.
Next steps
Quickstart
Install and run KiwiFS in 60 seconds.
Configuration
Configure search, auth, versioning, and more.
Agent Interface
How AI agents read and write markdown.
MCP
Connect Claude, Cursor, and other AI tools.
Draft spaces
Stage agent edits in git-backed drafts before merge.
Bases (views)
Saved DQL queries with table and board layouts.
Web UI
Browse, edit, and visualize your knowledge base.
Examples
Agent workflows, DQL, import, and deployment recipes.
FAQ
Common questions about KiwiFS.