Skip to main content

ARC Brain

Note-taking and knowledge graph wired into every ARC domain.

Layers​

  • Parser (server/src/modules/brain/core) — pure markdown functions, no DB
  • Registry (server/src/modules/brain/registry) — entity descriptors for every linkable model
  • Services (server/src/modules/brain/services) — notes, folders, links, index, search, sync, views, autolink, filing, import/export, canvas
  • API (/api/v1/brain/*) — notes, databases, forms (/forms, /forms/:id/submit, /public/forms/:slug/submit)
  • MCP (brain_* tools) — same services, different transport
  • Sync — vault files under BrainSettings.vaultPath
  • UI (/brain, /brain/note/:id, /brain/entity/..., /brain/canvas, /brain/maintenance)

Relationship to ClaudeContext​

Brain is the human knowledge vault (notes, folders, wikilinks, Obsidian export).

ClaudeContext remains the LLM / agent memory layer (context_* tools, coach context pack). They coexist. Brain does not replace or migrate away context keys.

Docs​

<BrainPanel /> is on person, journal, recipe, book, goals, kanban, pets, plants, assets, vehicles, travel, courses, media, fragrance, jewelry, cellar, health records, inventory, wishlist, happenings, groups, ingredients, wardrobe, home, workouts, projects. Meal / finance / dreams / emotions skip it when there is no selected entity.

Phase status​

  • Phase 1 — Foundation: done
  • Phase 2 — Core notes/folders: done
  • Phase 3 — File sync: done (core + optional vault git via BrainSettings.gitEnabled)
  • Composition — done (include/split)
  • Phase 4 — MCP: done (core + extended, including zip export/ingest)
  • Phase 5 — Search: done (hybrid FTS/fuzzy/RRF + local embeddings + /brain/search)
  • Phase 6a — Editor: done (CM6 + slash commands + live split preview + rich preview)
  • Phase 6b/c — Views/embeds: done (interactive arc-view/chart widgets in preview)
  • Phase 7 — Integration: done for BrainPanel across major domain pages + EntityLink + Cmd+K + nav + dossier
  • Phase 8 — Graph: done for local graph API + force-graph UI on note page + folder stats
  • Phase 9 — Autolink/filing: done for suggest links + inbox filing UI
  • Phase 10 — Import/export: done for JSON + markdown map + Obsidian zip
  • Phase 11 — Polish: done for what-can-i-do, maintenance, Settings prompts, coach Brain-first
  • Phase 12 — Canvas: done (Excalidraw visual editor + JSON escape hatch)
  • Tasks: dueDate / priority / completedAt on Task model + API/MCP
  • Attachments, properties, folder index, metrics embeds, settings UI, saved queries/views: done (maintenance + note sidebar + /brain/views)
  • Filing rules manager + MCP settings/filing tools + arc-graph preview fence: done
  • Hybrid search on Brain home + vault sync conflict resolver UI: done
  • All ARC entities linkable/embeddable (emotions + catalogs); slash /entity + /embed-entity; ⌘⇧L/E/A; powerful filters (tags/folders/links/entities): done