Skip to main content

​
1. Install

curl -fsSL https://raw.githubusercontent.com/kiwifs/kiwifs/main/install.sh | sh

​
2. Initialize a knowledge base

kiwifs init --template knowledge --root ./knowledge
This creates a directory with starter files, a schema, and an agent playbook.
Templates available: knowledge (default), wiki, runbook, research, tasks, blank. See Init templates for details on each.

​
3. Start the server

kiwifs serve --root ./knowledge
KiwiFS is now running at http://localhost:3333. Open it in your browser to see the web UI.

​
4. Write from your agent

curl -X PUT 'http://localhost:3333/api/kiwi/file?path=concepts/auth.md' \
  -H "X-Actor: my-agent" \
  -d "# Authentication

OAuth2 + JWT based authentication system."

curl 'http://localhost:3333/api/kiwi/search?q=authentication'

​
Connect an AI agent

Add KiwiFS as an MCP server in Claude Desktop or Cursor: 
{
  "mcpServers": {
    "kiwifs": {
      "command": "kiwifs",
      "args": ["mcp", "--root", "/path/to/knowledge"]
    }
  }
}
Your agent now has access to 60+ MCP tools for reading, writing, searching, querying, drafts, and more. See MCP for the full tool reference.

​
Next steps

Configuration

Auth, search, versioning, vector embeddings, and more.

Agent Interface

Filesystem, REST, and MCP access patterns.

DQL

Query frontmatter metadata with a SQL-like language.

Deploy with Docker

Production deployment with Docker Compose.

Web UI

Tree, editor, graph, Bases, and search.

Episodic memory

Episodes, consolidation, and memory reports.
Last modified on May 30, 2026