Skip to main content
DuckBrain ingests your personal and work data (Slack, iMessage, Claude Code sessions, markdown notes) into an open DuckLake lakehouse on your machine, and gives agents one queryable surface: the duckbrain CLI.

​
Principles

  • Local-first. Everything lives at ~/.duckbrain/<instance>/ as SQLite + Parquet. Nothing leaves the machine; embeddings run locally.
  • Raw data is the system of record. Sources land verbatim in an append-only bronze layer; search indexes are disposable caches rebuilt from the lake.
  • Agents compose simple verbs. Search-first retrieval with four facet flags — no natural-language parsing inside the CLI.
  • One brain, many attachments. Instances give hard isolation per agent; workspaces attach with scoped views.

​
Quick start

That’s the whole surface. After init, the brain keeps itself fresh — streaming session ingest, a sync schedule, and Claude Code hooks, all behind one switch (duckbrain sync on|off|status). Manual refresh anytime: duckbrain sync or duckbrain sync slack.