⭐ If Kuku feels useful or interesting, a GitHub star helps the project reach more people.

What Is Kuku?

Kuku is an open-source Markdown app for people who want their notes to stay portable, private, and useful to AI. It edits ordinary .md files in a local vault, then layers search, graph navigation, AI assistance, Second Brain workflows, and encrypted sync on top.

The project is not just a desktop app. This repository includes the macOS client, web app, Go server, protobuf contracts, Rust AI/indexing crates, and Docker infrastructure needed to inspect or self-host the system.

Why It Exists

• Your files should stay yours: notes remain plain Markdown, not hidden platform data.
• AI should be reviewable: AI can read, search, and propose changes, but edits flow through approval and diffs.
• Knowledge should improve explicitly: decision documents turn AI proposals into traceable memory and wiki updates.
• Infrastructure should be inspectable: server, sync, contracts, and deployment code live in the open.
• Cloud should be optional: use Kuku locally, sign in for managed convenience, or self-host the stack yourself.

Highlights

• Local Markdown vault: open a folder and keep writing in files that work with git, vim, Obsidian, and other Markdown tools.
• Personal wiki: connect notes with [[wikilinks]], backlinks, search, and 2D / 3D graph navigation.
• Second Brain workflows: manage memory, wiki pages, proposals, and decisions as Markdown inside your vault.
• Self-improving AI context: accept, reject, or revise decision documents so future AI conversations inherit better context.
• AI-native editing: use Agent / Ask / Inline modes, attach files or selected text, and review proposed edits before applying.
• Encrypted sync foundation: sync workspaces, devices, key envelopes, signed commits, and encrypted objects without exposing plaintext notes to the server.

Install

The official build is currently available for macOS.

• Recommended: download from the website: visit kuku.mom and download the latest macOS build.

• Homebrew: install from the Kuku tap.

  brew install kuku-mom/kuku/kuku
  

• GitHub Releases: download the DMG directly from GitHub Releases.

Platform status:

• macOS: supported
• Windows: coming soon
• Linux: coming soon

Open Source

Kuku is built as a full-stack open-source project, not a thin client around a closed service. If you want to explore how it works, start with:

• DeepWiki codebase guide
• Development and self-hosting notes
• Public roadmap

Contributing

Bug reports, feature ideas, documentation improvements, and pull requests are welcome. For larger changes, please open an issue first so we can align on direction.

Kuku's core principle is simple: your files belong to you, and the tool should not take that control away.

License

MIT © kuku-mom