kuku-mom/kuku

Kuku is a local-first Markdown workspace for macOS that layers wiki links, backlinks, search, graphs, AI editing, Second Brain workflows, and encrypted synchronization over ordinary files. Keeping notes compatible with Git, Vim, Obsidian, and other Markdown tools protects portability. AI changes flow through reviewable diffs and decision documents, while the repository includes the desktop client, web app, sync server, contracts, indexing components, and self-hosting infrastructure rather than hiding core behavior behind a closed service.

Encrypted sync and AI access deserve precise documentation. Users need a threat model covering key creation, recovery, device revocation, metadata leakage, conflict resolution, signed commits, server compromise, and backups. The AI layer should disclose provider requests, indexing boundaries, prompt-injection handling, and how rejected proposals are forgotten. Windows and Linux remain future work, so the project should set realistic portability expectations beyond the file format itself. Kuku is best for macOS users who want a polished personal knowledge environment while retaining plain files and approval over AI edits, especially those willing to evaluate a relatively young synchronization system carefully.

Kuku is a really promising project. It has a clear point of view: keep Markdown files local and portable, then add the modern pieces people want around them, like wiki links, graph views, AI editing, diff approval, and encrypted sync. That is a strong niche, especially for users who like Obsidian-style ownership but want a more native, AI-aware macOS app.

The repo looks substantial, not just a thin demo. It includes the Tauri/SolidJS desktop app, Astro web app, Go server, Rust AI/indexing crates, protobuf contracts, Docker setup, migrations, and a good spread of tests. The README is also clear, polished, and honest about platform support.

My main suggestion would be to make contributor trust even stronger: add visible GitHub Actions CI, a SECURITY.md, and a short CONTRIBUTING.md with the easiest local setup path. Since Kuku handles local files, AI access, and encrypted sync, those details would help users and contributors feel safer adopting it.

Overall, Kuku feels thoughtful, technically serious, and genuinely useful. It already has a strong foundation; the next improvements are mostly about making the project easier to trust, verify, and contribute to.