Superpersonalized AI agent that shares a knowledge base with you.
Local-first. Open source. Works with Obsidian, Logseq, or any Markdown folder.
Website · Download · Discussions
Most AI forgets you after every chat. meld doesn't.
You and AI share the same files — both read, write, and build on the same knowledge base. Point meld at your folder of Markdown notes. It indexes them, answers questions with source citations, creates new notes autonomously, and gets smarter from every interaction. Every AI edit is auto-committed to git so you can always roll back.
| Problem | How meld solves it |
|---|---|
| Every AI chat starts from a blank slate | meld reads your existing notes — it already knows your context |
| AI-generated content disappears after the session | meld writes to real files on your disk — knowledge persists forever |
| You need 5 tools to capture, organize, search, connect, create | One agent does it all — ask a question, get an answer, it creates the note |
| AI tools require cloud sync and accounts | Everything stays on your machine. Bring your own API key |
| You can't trust AI edits | Git auto-commits before every change — undo anything, anytime |
- Works with what you have — Obsidian vaults, Logseq graphs, or any folder of
.mdfiles - Answers from your notes — ask anything, get answers with clickable citations back to your files
- Autonomous agent — researches, creates, edits, and links notes without being asked
- Web search — optional Tavily integration to ground answers with live data
- Nothing leaves your machine — all data stays local, no cloud sync, no telemetry
- Git safety net — every change is auto-committed; undo anything from the UI
- Bring your own key — OpenAI, Anthropic, Google, or local Ollama
- Tiny footprint — cross-platform desktop app under 15 MB
You: "What did we decide about the B2B pivot?"
meld: searches 847 notes → finds [[March Retro]], [[Pricing Research]],
[[Customer Interviews Q4]] → answers with citations →
auto-creates notes/b2b-pivot-analysis.md → git commits the change
- You ask — natural language, any question about your knowledge
- It knows — semantic search across your entire vault, grounded in your context
- It acts — creates notes, connects ideas, builds on what exists
macOS: The app is not notarized (no Apple Developer certificate). On first launch macOS may say the app is "damaged". Fix with:
xattr -cr /Applications/meld.app
- Download and install meld
- Open it and point to your Markdown folder (or create a new one)
- Add an API key in Settings (OpenAI, Anthropic, Google, or set up Ollama)
- Start chatting — meld indexes your notes automatically
- API keys stored locally in
~/.meld/config.toml— never leave your device except to call your chosen provider - Your notes stay on your machine — no cloud, no sync, no tracking, no telemetry
- Git safety — every vault write is auto-committed for full history and safe rollback
- Open source (AGPL-3.0) — audit the code yourself
| meld | ChatGPT / Claude | Obsidian Copilot | Mem.ai | Khoj | |
|---|---|---|---|---|---|
| Remembers your context | Persistent vault | Per-session only | Plugin-level | Cloud-only | Self-hosted |
| Your files, your disk | Local Markdown | Cloud | Local (plugin) | Cloud | Self-hosted |
| Autonomous note creation | Yes — agent writes | No | No | Limited | Limited |
| Git version control | Auto-commits | N/A | N/A | N/A | N/A |
| Open source | AGPL-3.0 | No | Partial | No | Yes |
| Works offline (Ollama) | Yes | No | No | No | Yes |
| Desktop app | Tauri (15 MB) | Web | Plugin | Web | Web |
Tauri 2.0 desktop app — Rust backend, Next.js frontend.
- Core: Agent state machine with safety budgets (iterations, tokens, time)
- RAG:
pulldown-cmark→sqlite-vec(cosine similarity) → top-K context assembly - Storage: SQLite + local Markdown files, git2 for version control
- LLM: OpenAI / Anthropic / Google (BYOK) or local Ollama
- Tools: MCP protocol —
kb_search,kb_read,kb_create,kb_update,kb_list,web_search
- Rust (stable)
- Node.js (v22+)
- pnpm
- Tauri prerequisites for your OS
pnpm install # Install frontend dependencies
cargo tauri dev # Run in development mode with hot reload
cargo tauri build # Build production binarycargo test --manifest-path src-tauri/Cargo.toml # Rust tests
cargo clippy --manifest-path src-tauri/Cargo.toml # Lint
pnpm lint # ESLint
pnpm typecheck # TypeScriptSee CONTRIBUTING.md for setup, PR process, and code style.
See SECURITY.md for vulnerability reporting.
AGPL-3.0 — free to use, modify, and distribute. If you run a modified version as a service, you must open-source your changes.
Built by kizz · Follow on X · Sponsor
