Optional features - KiwiFS — Markdown filesystem for agents and teams

Feature matrix

Feature	How to enable	Error when disabled
Draft spaces	Git versioning (not `none`)	`501`
Claims	Claim store at bootstrap	`503`
Audit log	`[audit] enabled = true`	`501`
Vector search	`[search.vector] enabled = true`	`503`
Webhooks	`[webhooks] enabled = true`	Empty CRUD
Schema enforcement	`[schema] enforce = true`	Writes pass without validation
Graph analytics	Link index available	`503`
Import connections	Store init success	`[]` from list endpoint

Enabling subsystems

Drafts

Drafts require git-backed branches. Ensure versioning is not none:

.kiwi/config.toml

[versioning]
strategy = "git"

See Draft spaces.

Claims

Task claims prevent two agents from editing the same path concurrently. The claim store is wired at bootstrap when the server detects the feature is needed.See Claims.

Audit log

.kiwi/config.toml

[audit]
enabled = true

curl 'http://localhost:3333/api/kiwi/audit?since=2026-05-01T00:00:00Z&limit=100'

See Utilities API.

Vector search

.kiwi/config.toml

[search.vector]
enabled = true

[search.vector.embedder]
provider = "openai"
model = "text-embedding-3-small"
api_key = "${OPENAI_API_KEY}"

[search.vector.store]
provider = "sqlite-vec"

See Search and Configuration.

Schema enforcement

.kiwi/config.toml

[schema]
enforce = true

When enabled, writes with invalid frontmatter are rejected. Define types under .kiwi/schemas/.See Schemas.

If you see 501 or 503 on an endpoint, check the table above. These are not bugs — they mean the subsystem was not configured for this server instance.

Configuration

Full config.toml reference.

API overview

Auth and error conventions.

​Feature matrix

​Enabling subsystems

​Related documentation

Configuration

API overview

Feature matrix

Enabling subsystems

Related documentation