Kuku

A local-first, open-source Markdown knowledge workspace for macOS — plain files, personal wiki and Second Brain workflows, AI-assisted diffs, and encrypted sync, built as an Obsidian alternative.

186stars
37forks
MIT License
Rust

Kuku is a native macOS app for personal knowledge management, built around plain Markdown files rather than a proprietary database, positioning itself directly as an open-source Obsidian alternative. It supports personal wiki and Second Brain workflows, and adds AI-assisted diffs for reviewing AI-suggested changes to notes rather than accepting them blindly.

Beyond local storage, Kuku offers encrypted sync, letting the same knowledge base stay available across devices without trusting a third party with unencrypted note content. It’s built with Tauri and SolidJS, giving it a lightweight native-feeling app on top of a web-tech UI stack rather than a heavier Electron footprint.

MIT licensed, Kuku has been featured on Product Hunt as an open-source, local-first second brain, and its own topics explicitly identify it as targeting the same use case as Obsidian and similar personal knowledge management tools.

What You Get

  • A native macOS app for Markdown-based personal knowledge management, built with Tauri and SolidJS
  • Local-first storage using plain Markdown files rather than a proprietary database format
  • Encrypted sync for keeping a knowledge base consistent across devices without trusting unencrypted data to a third party
  • AI-assisted diffs for reviewing AI-suggested changes to notes before accepting them

Common Use Cases

  • Running a personal Second Brain or wiki workflow using plain Markdown files instead of a proprietary note format
  • Migrating from Obsidian to an open-source alternative with similar local-first, file-based principles
  • Syncing a personal knowledge base across multiple Macs with end-to-end encryption
  • Using AI to suggest note edits while retaining a reviewable diff instead of silent AI overwrites

Under The Hood

Architecture Kuku is a Tauri application, pairing a Rust backend with a SolidJS frontend — a lighter-weight alternative to Electron-based note apps while still delivering a modern web-tech UI. Its file-based, local-first design means the knowledge base is fundamentally a directory of Markdown files rather than data locked inside an app-specific database, with encrypted sync layered on top as a separate concern from local storage.

Tech Stack Rust (via Tauri) for the application shell and backend, SolidJS for the frontend UI, targeting macOS specifically rather than being cross-platform from the start. AI-assisted diffing suggests an integration with an LLM for generating suggested edits, reviewed before being applied.

Code Quality Very active, consistently maintained commit history and a DeepWiki-generated documentation badge (indicating AI-assisted documentation generation from the codebase) reflect an actively iterated project; as a young app, longer-term maturity signals are still developing.

What Makes It Unique Most AI note-taking tools either lock content into a proprietary format or apply AI edits without an explicit review step; Kuku combines a plain-Markdown, local-first foundation (portable and inspectable) with AI-assisted diffs specifically designed to keep AI-suggested changes reviewable rather than silently applied.

Self-Hosting

Licensing Model MIT licensed — fully open source with no license key.

Self-Hosting Restrictions Not applicable; it’s a local macOS app with optional encrypted sync you control, not a hosted service.

License Key Required No.

Join founders buildingwith open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on Substack

No spam. Unsubscribe anytime.

Join 750+ subscribers
No spam. Unsubscribe anytime.

Search