Skip to content

Repository files navigation

meld icon

meld

Superpersonalized AI agent that shares a knowledge base with you.
Local-first. Open source. Works with Obsidian, Logseq, or any Markdown folder.

Latest Release GitHub Stars License: AGPL-3.0 Downloads

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.

meld — chat with AI while browsing the note it created

Why meld

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

Features

  • Works with what you have — Obsidian vaults, Logseq graphs, or any folder of .md files
  • 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

How it works

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
  1. You ask — natural language, any question about your knowledge
  2. It knows — semantic search across your entire vault, grounded in your context
  3. It acts — creates notes, connects ideas, builds on what exists

Download

OS Download
macOS macOS ARM64
macOS x64
Windows Windows Setup
Windows MSI
Linux Linux AppImage
Debian/Ubuntu
Fedora/RHEL

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

Quick Start

  1. Download and install meld
  2. Open it and point to your Markdown folder (or create a new one)
  3. Add an API key in Settings (OpenAI, Anthropic, Google, or set up Ollama)
  4. Start chatting — meld indexes your notes automatically

Privacy

  • 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

Comparison

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

Tech Stack

Tauri 2.0 desktop app — Rust backend, Next.js frontend.

  • Core: Agent state machine with safety budgets (iterations, tokens, time)
  • RAG: pulldown-cmarksqlite-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

Development

Prerequisites

Build & Run

pnpm install        # Install frontend dependencies
cargo tauri dev     # Run in development mode with hot reload
cargo tauri build   # Build production binary

Test

cargo test --manifest-path src-tauri/Cargo.toml   # Rust tests
cargo clippy --manifest-path src-tauri/Cargo.toml  # Lint
pnpm lint                                          # ESLint
pnpm typecheck                                     # TypeScript

Contributing

See CONTRIBUTING.md for setup, PR process, and code style.

Security

See SECURITY.md for vulnerability reporting.

License

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

About

Superpersonalized AI agent that shares a knowledge base with you. Local-first, open source, works with Obsidian.

Topics

Resources

Contributing

Security policy

Stars

6 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages