Docs · Obsidian

Open your brain in Obsidian

Your .claude/brain/ directory is already a valid Obsidian vault. It is flat markdown with [[wiki-links]], exactly what Obsidian reads natively. RepoOps ships the dashboard for reading your brain; Obsidian is the best-in-class human editor for it. This pack is the small config plus example queries that turn your existing brain into a graph view with live dashboards. Near-zero code, no export step, no lock-in.

Point Obsidian at your brain

Install Obsidian (free, desktop).
Open folder as vault and pick your .claude/brain/ directory (the one in your repo for the RepoOps localhost brain, or the local mirror the desktop app keeps for your personal brain, or a personal-brain export).
That is the whole setup. Your notes are the single source of truth; nothing is copied or converted.

Install Dataview for live dashboards

The Dataview community plugin turns your flat notes into live tables and lists. Settings → Community plugins → Browse → search Dataview→ Install → Enable. RepoOps references Dataview in the vault template’s .obsidian/community-plugins.json (it does notbundle the plugin binary), so you install it once from Obsidian’s own registry.

The vault template

The template lives in the repo at docs/obsidian/vault-template/. It supplies a sensible .obsidian/ config (wiki-links not markdown links, the browse-friendly core plugins, Dataview referenced) and a set of example notes under _obsidian-examples/ that resolve against your own brain:

Sessions by date: every session journal entry, newest first (dates parse straight from the YYYY-MM-DD-<slug>.md filenames).
Brain map by type: brain state-docs grouped by their type: frontmatter (Error Log, Decision Log, and so on).
What links here: the backlink graph plus the wiki-links that resolve in a RepoOps brain ([[INDEX]], [[errors]], [[decisions]]).

Copy the example notes you want into your vault; leave the rest. They are plain markdown and safe to delete. Or drop the template’s .obsidian/ folder into your own brain to adopt the config.

Example Dataview query

List every session, newest first:

```dataview
TABLE WITHOUT ID
  file.link AS "Session",
  file.day AS "Date"
FROM "sessions"
SORT file.day DESC
```

Wiki-links and the graph resolve out of the box

The brain already cross-references notes with [[wiki-links]], so Obsidian’s graph view and backlinks pane light up immediately. Open [[INDEX]](the brain’s own index) and the backlinks pane shows every note that references it. The graph view (left ribbon) shows the whole brain and how its notes connect.

Edits flow back through the write-trust guard

Because Obsidian edits the same files RepoOps reads, a change you make in Obsidian is a change to your brain, no sync step. For your personal brain, writes still pass through the write-trust guard: a human edit lands as a provenanced, reversible change rather than a silent overwrite of an active memory. Your brain stays plain files that you own, readable and editable by any markdown tool.

← Ask the brain