Skip to main content
KiwiFS ships a full web UI embedded in the Go binary. Open http://localhost:3333 after kiwifs serve — no separate install.

Features

File tree

Expand, collapse, drag-drop, and context menu on markdown files.

Editor

Source-preserving BlockNote editor. Keeps on-disk formatting stable.

Search

Cmd+K opens global BM25 search. Semantic results appear when vector search is configured.

Graph view

Force-directed wiki-link network.

Bases

Saved DQL queries with table or board layouts.

Canvas

Interactive Flow diagrams from .canvas.json files.

Whiteboard

Excalidraw sketches in .excalidraw.md files.

Kanban

Boards driven by workflow state machines.

Comments

Inline annotations on specific lines.

Data sources

Saved import connections with auto-sync.

Layout

The UI uses a three-pane layout:
PaneContents
SidebarFile tree, space switcher (multi-space mode)
MainPage view or editor
PanelsBacklinks, ToC, comments, page view counts

File tree

The sidebar file tree supports expand/collapse, drag-and-drop reordering, and context menus for rename, duplicate, move, and delete. You can drag files from your operating system into the tree to import them as markdown pages.

Toolbar views

Beyond the page editor, the header toolbar opens full-screen views:
ButtonView
Knowledge graphForce-directed wiki-link network
BasesSaved DQL queries with table or board layouts
CanvasInteractive Flow editor for .canvas.json files
WhiteboardExcalidraw hub for .excalidraw.md files
TimelineRecent git-backed activity
KanbanWorkflow boards grouped by state
Data sourcesSaved import connections and sync controls
See Canvas, Whiteboard, and Import connections.

Engagement metrics

When analytics tracking is enabled, page view counts appear in the page header. The kiwifs analytics CLI command and GET /api/kiwi/analytics REST endpoint also report engagement data — top viewed pages and failed searches that indicate content gaps. See Analytics API.

Page view and editor

Rendered markdown with wiki links, Mermaid diagrams, and frontmatter-aware styling.

Wiki navigation

  • [[wiki links]] render as clickable links; unresolved links are highlighted.
  • Backlinks panel lists pages linking to the current page.
  • Graph view visualizes the wiki-link network.

Publishing

Use Publish in the page header (or POST /api/kiwi/publish) to set published: true in frontmatter. Published pages are readable at /p/{path}. See Publish API.

Themes

Built-in themes: kiwi, ocean, forest, sunset, neutral. Users can switch unless locked:
.kiwi/config.toml
[ui]
theme_locked = false

Mobile

The UI is responsive. Reading works well on phones; editing is best on desktop.
A standalone kiwifs-ui npm package for React embedding is on the roadmap. Until then, use Go embed or proxy GET / from your app.

Quickstart

Install and run in 60 seconds.

Wiki links

Syntax and backlink behavior.

Bases

Saved views and DQL.

Canvas

Spatial diagrams.

Whiteboard

Excalidraw sketches.
Last modified on May 23, 2026