kiwifs/kiwifs
Markdown filesystem for agents and teams.
What it solves
KiwiFS 解决了原始 Markdown 文件缺乏结构、可搜索性和版本控制,导致 AI 代理和团队无法高效协作的问题。它将一个 .md 文件目录转换为可写、可搜索且具版本控制的知识库,同时保持人类可读且可迁移,避免了专有 SaaS 数据库的锁定。
How it works
KiwiFS 作为单个 Go 二进制文件运行,将磁盘上的 Markdown 文件管理为唯一真实来源。它提供一个
- Agent Interface:AI 代理可以通过 62 种原生 MCP(Model Context Protocol)工具、REST API 或直接文件系统访问(NFS、S3、WebDAV、FUSE)与文件交互。
- Search Index:实现全文搜索(通过 SQLite FTS5 的 BM25)和可插件化的向量搜索(支持 OpenAI、Ollama、ONNX、Cohere 以及 Qdrant、Pinecone 等向量存储)。
- Versioning:每一次写入操作都会自动转换为原子 Git 提交,提供完整审计追踪和时间点恢复能力。
- Human Interface:嵌入式 Web UI 包含块编辑器、Wiki 链接和知识图谱可视化,供人类浏览和编辑。
Who it’s for
- AI Agent Builders:开发需要持久、结构化记忆或工作空间的代理,使上下文能够跨会话累积。
- Teams replacing Notion/Confluence:寻求自托管、基于 Markdown 的 Wiki,且没有供应商锁定的团队。
- Compliance-heavy industries:需要通过 Git 提供不可变审计追踪的组织。
- DevOps/Platform teams:维护可在事故后由代理自动更新的 Runbook 团队。
Highlights
- Native MCP Integration:62 个工具,无缝连接 Claude、Cursor 与其他 MCP 客户端。
- Hybrid Search:结合全文和语义向量搜索,并提供零依赖本地 ONNX 嵌入器选项。
- DQL Queries:对 Markdown frontmatter 进行类 SQL 查询,以获取结构化数据。
- Zero Config:以单个二进制文件和嵌入前端分发。
- Multi-space:支持多个隔离工作空间,每个都有自己的 Git 仓库和搜索索引。