Documentation Index
Fetch the complete documentation index at: https://docs.kiwifs.com/llms.txt
Use this file to discover all available pages before exploring further.
1. Install
curl -fsSL https://raw.githubusercontent.com/kiwifs/kiwifs/main/install.sh | sh
go install github.com/kiwifs/kiwifs@latest
docker run -p 3333:3333 -v ./knowledge:/data ameliaanhlam/kiwifs
The Docker image runs kiwifs serve with default settings. Skip to step 4 — init and serve are handled automatically.
2. Initialize a knowledge base
kiwifs init --template knowledge --root ./knowledge
Templates available: knowledge (default), wiki, runbook, research, blank.
3. Start the server
kiwifs serve --root ./knowledge
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."
5. Search
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"]
}
}
}
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.
