Kuku
A local-first Markdown workspace for macOS with AI edit review, linked notes, and encrypted sync. Keep files locally or self-host the server.
Kuku is a local-first Markdown workspace for macOS, aimed at people who want a personal wiki with AI assistance while keeping their notes as ordinary files. It stores notes in a local folder, so they remain usable in Obsidian, vim, git, and other Markdown tools. The editor works offline; cloud services are optional.
Wikilinks and backlinks connect related notes, while search and 2D or 3D graph views help you find material and see its connections. Alongside everyday notes, the workspace keeps memory, wiki pages, AI proposals, and decision documents in Markdown.
AI can read and search your notes, work with attached files or selected text, and suggest edits. You review the proposed changes as diffs before applying them. Decision documents let you accept, reject, or revise proposals and carry that context into future AI conversations, giving you a record of how the knowledge in your vault develops.
For use across devices, encrypted sync keeps plaintext notes hidden from the sync server. You can use the app locally, sign in for a managed service, or self-host the stack. The project includes a web app and server infrastructure alongside the macOS client, rather than requiring a closed hosted service for sync.
Kuku is open source under the MIT license. Its published code includes the Go server, Rust AI and indexing components, and Docker infrastructure for self-hosting.
