# KiwiFS — Markdown filesystem for agents and teams ## Docs - [Analytics and health](https://docs.kiwifs.com/api/analytics.md): Knowledge health dashboard, per-page health checks, comments, sharing, and real-time events. - [Canvas](https://docs.kiwifs.com/api/canvas.md): List, read, write, patch, query, and auto-layout .canvas.json files. - [Claims](https://docs.kiwifs.com/api/claims.md): Claim, release, and list cooperative write leases on file paths. - [Drafts](https://docs.kiwifs.com/api/drafts.md): Create, edit, merge, or discard git-backed draft workspaces under /api/kiwi/drafts. - [Files](https://docs.kiwifs.com/api/files.md): Read, write, delete, and bulk-manage files through the KiwiFS REST API. - [Import and export](https://docs.kiwifs.com/api/import-export.md): REST import (including browse, preview, saved connections, and file ingest) and export formats. - [Metadata and graph](https://docs.kiwifs.com/api/metadata.md): DQL queries, aggregations, backlinks, and knowledge graph endpoints. - [API overview](https://docs.kiwifs.com/api/overview.md): Base URL, authentication, common headers, and error handling for the KiwiFS REST API. - [Publish](https://docs.kiwifs.com/api/publish.md): Publish and unpublish pages via frontmatter and read them at /p/{path}. - [Schemas](https://docs.kiwifs.com/api/schemas.md): Manage JSON Schema definitions for frontmatter validation. - [Search](https://docs.kiwifs.com/api/search.md): Full-text, trust-ranked, vector, and metadata search endpoints. - [Spaces admin](https://docs.kiwifs.com/api/spaces.md): List, create, and remove knowledge spaces on a multi-space KiwiFS server. - [Utilities and agent helpers](https://docs.kiwifs.com/api/utilities.md): Symlinks, linting, peek and section reads, timeline and feeds, clipping, extended graph APIs, rules, space settings, audit logs, and public share URLs. - [Velocity and graph analytics](https://docs.kiwifs.com/api/velocity.md): Change velocity, PageRank, and structural analysis of your knowledge base. - [Versioning](https://docs.kiwifs.com/api/versioning.md): Git history, diff, and blame endpoints for tracking changes to your knowledge base. - [Views (Bases)](https://docs.kiwifs.com/api/views.md): List, save, delete, and execute saved DQL views stored in .kiwi/views. - [Webhooks](https://docs.kiwifs.com/api/webhooks.md): Register, list, and delete webhooks for real-time change notifications. - [Workflows](https://docs.kiwifs.com/api/workflows.md): CRUD workflow definitions and advance page state with validation. - [CLI commands](https://docs.kiwifs.com/cli/commands.md): KiwiFS command-line reference. - [Agent Interface](https://docs.kiwifs.com/concepts/agent-interface.md): How AI agents read and write markdown in KiwiFS. - [Agent playbook](https://docs.kiwifs.com/concepts/agent-playbook.md): SCHEMA.md, playbook.md, rules.md, and kiwi_context — how agents onboard to a knowledge base. - [Audit log](https://docs.kiwifs.com/concepts/audit-log.md): Track every API request with structured audit entries for compliance and debugging. - [Bases and saved views](https://docs.kiwifs.com/concepts/bases-views.md): Named DQL queries with columns, filters, and layout — table, list, calendar, or kanban over your frontmatter. - [Canvas files](https://docs.kiwifs.com/concepts/canvas.md): JSON Canvas files for spatial diagrams — nodes, edges, interactive Flow rendering, and graph-assisted layout. - [Task claims](https://docs.kiwifs.com/concepts/claims.md): Short-lived leases so multiple agents do not edit the same page at the same time. - [DQL](https://docs.kiwifs.com/concepts/dql.md): A SQL-like query language for frontmatter metadata across your knowledge base. - [Draft spaces](https://docs.kiwifs.com/concepts/draft-spaces.md): Git-backed staging branches so agents can prepare changes before merging to the live knowledge base. - [Episodic memory](https://docs.kiwifs.com/concepts/episodic-memory.md): Separate raw agent sessions from durable semantic pages using frontmatter conventions and merge reports. - [Files as truth](https://docs.kiwifs.com/concepts/files-as-truth.md): Why KiwiFS uses plain markdown files as the source of truth. - [MCP (Model Context Protocol)](https://docs.kiwifs.com/concepts/mcp.md): Connect Claude, Cursor, and other AI tools to KiwiFS — stdio, HTTP, and 68+ tools. - [Multi-space](https://docs.kiwifs.com/concepts/multi-space.md): Run multiple isolated knowledge bases on one KiwiFS server with path or header routing. - [Optional features](https://docs.kiwifs.com/concepts/optional-features.md): Which subsystems need configuration and what HTTP status codes mean when they are off. - [Publishing and sharing](https://docs.kiwifs.com/concepts/publishing.md): Make pages publicly accessible via publish flags, share links, or space visibility. - [Real-time events](https://docs.kiwifs.com/concepts/real-time-events.md): Subscribe to write, delete, and bulk events over Server-Sent Events (SSE). - [Schema Validation](https://docs.kiwifs.com/concepts/schemas.md): Enforce structure on your markdown with JSON Schema validation on writes. - [Search](https://docs.kiwifs.com/concepts/search.md): Three tiers of search: grep, SQLite FTS5, and vector embeddings. - [Versioning](https://docs.kiwifs.com/concepts/versioning.md): Git-backed versioning strategies: full git, copy-on-write, or none. - [Webhooks](https://docs.kiwifs.com/concepts/webhooks.md): Push real-time notifications to external services when pages change. - [Whiteboard](https://docs.kiwifs.com/concepts/whiteboard.md): Excalidraw diagrams stored as markdown files — create, edit, and share freeform drawings in the web UI. - [Widgets and block types](https://docs.kiwifs.com/concepts/widgets.md): Charts, kanban boards, playgrounds, diffs, and other rich blocks you can embed in markdown pages. - [Wiki links](https://docs.kiwifs.com/concepts/wiki-links.md): Link pages with [[wiki-link]] syntax and explore the knowledge graph. - [Workflows](https://docs.kiwifs.com/concepts/workflows.md): JSON state machines in .kiwi/workflows — pages carry workflow and state in frontmatter for Kanban-style boards. - [Configuration](https://docs.kiwifs.com/configuration.md): Configure KiwiFS via .kiwi/config.toml — search, auth, versioning, vector embeddings, and more. - [Backup sync](https://docs.kiwifs.com/deploy/backup-sync.md): Push your KiwiFS knowledge root to a git remote and avoid routine non-fast-forward backup failures. - [Docker](https://docs.kiwifs.com/deploy/docker.md): Deploy KiwiFS with Docker. - [Go embed](https://docs.kiwifs.com/deploy/go-embed.md): Embed KiwiFS in your Go application. - [Kubernetes](https://docs.kiwifs.com/deploy/kubernetes.md): Deploy KiwiFS on Kubernetes. - [Ollama vector search on a small VPS](https://docs.kiwifs.com/deploy/ollama-vector-search.md): Run semantic search with a local Ollama embedder, sqlite-vec, and low-concurrency vector indexing. - [Document export](https://docs.kiwifs.com/export/documents.md): Render markdown to PDF, HTML, slides, or a static site. - [Data export](https://docs.kiwifs.com/export/overview.md): Export your knowledge base as JSONL, CSV, or Parquet. - [Alternate protocols](https://docs.kiwifs.com/guides/alternate-protocols.md): Mount and integrate KiwiFS over NFS, S3, WebDAV, and FUSE alongside REST and MCP. - [Authentication and tokens](https://docs.kiwifs.com/guides/auth-tokens.md): Configure API authentication — global keys, per-space tokens, and OIDC — and manage tokens via the CLI. - [KiwiFS Cloud](https://docs.kiwifs.com/guides/cloud.md): Connect to hosted KiwiFS workspaces — authentication, REST API, MCP, and CLI setup. - [Examples](https://docs.kiwifs.com/guides/examples.md): Practical workflows for agents, DQL, import/export, and deployment. - [FAQ](https://docs.kiwifs.com/guides/faq.md): Frequently asked questions about KiwiFS installation, agents, search, and deployment. - [POSIX and filesystem semantics](https://docs.kiwifs.com/guides/posix.md): POSIX compliance by access path — NFS, FUSE, atomic writes, and concurrency. - [Init templates](https://docs.kiwifs.com/guides/templates.md): Starter templates for new knowledge bases — kb, wiki, memory, tasks, data, cms, runbook, adr, prompt, research, log, and blank. - [Web UI](https://docs.kiwifs.com/guides/web-ui.md): Browse, edit, search, and visualize your knowledge base in the embedded KiwiFS web UI. - [Airbyte import](https://docs.kiwifs.com/import/airbyte.md): Sync data from Airbyte Docker connectors or Airbyte Cloud into markdown pages. - [Browse, preview, and saved connections](https://docs.kiwifs.com/import/connections.md): Discover tables and collections, preview import rows, and re-run imports without storing credentials on disk. - [Database imports](https://docs.kiwifs.com/import/databases.md): Import data from PostgreSQL, MySQL, SQLite, MongoDB, Firestore, DynamoDB, Redis, and Elasticsearch into KiwiFS. - [File imports](https://docs.kiwifs.com/import/files.md): Import data from CSV, JSON, JSONL, YAML, and Excel files into KiwiFS. - [Data Import](https://docs.kiwifs.com/import/overview.md): Import data from 18 sources into your KiwiFS knowledge base. - [SaaS imports](https://docs.kiwifs.com/import/saas.md): Import data from Notion, Airtable, Google Sheets, Obsidian, and Confluence into KiwiFS. - [Introduction](https://docs.kiwifs.com/index.md): KiwiFS is a markdown filesystem for agents and teams. Searchable. Structured. Versioned. One binary, zero config. - [Quickstart](https://docs.kiwifs.com/quickstart.md): Install and run KiwiFS in 60 seconds. ## OpenAPI Specs - [openapi](https://docs.kiwifs.com/api-reference/openapi.json) ## Optional - [GitHub](https://github.com/kiwifs/kiwifs)