BrainBar

A local-first macOS explorer for Graphify-powered Markdown graphs.

BrainBar turns existing Graphify output from your local Obsidian or Markdown vault into an interactive macOS graph workspace — search, focus, trace paths, review.

BrainBar turns existing Graphify output from a local Markdown or Obsidian vault into an interactive macOS graph workspace. It requires Graphify output, keeps Markdown canonical, and helps technical users search, focus, trace paths, review agent activity, and close out durable memory findings without uploading private vault content.

Graphify-powered · Markdown-canonical · Local-first.

Download BrainBar.dmg
Local-first by default.
Public-safe Graphify sample output
Graph Source Lens
Local-first by default.

See it in action

See BrainBar explore a real graph.

A short tour of BrainBar exploring a real Graphify graph — search, focus, paths, and review, on macOS.

Agent Activity

See what the agent touched.

Obsidian shows you your notes. BrainBar shows you what your agent does with them.
One click in Settings installs a Codex or Claude skill that streams agent activity — reads, writes, focus, closeouts, decisions — into BrainBar. Metadata only: never note contents, prompts, or secrets.

Works with
Codex · 1-click install from SettingsActive
Claude · 1-click install from SettingsActive
agent.activitymetadata-only
watch graphify-backed vault --local --redacted
readgraphify-out/graph.json

Agent checks the generated graph layer before proposing changes.

focusvault/notes/decision.md

Focus shifts to a public-safe decision note in the vault.

writevault/closeouts/session-note.md

A curated closeout records what changed and what should be remembered.

createvault/review/memory-proposal.md

A reviewable memory proposal is created instead of silent write-back.

checkgraphify-out/graph.html

Generated Graphify output is present and readable locally.

Metadata only

The activity stream shows file events, not private content.

BrainBar can surface reads, writes, creates, focus changes, and checks around a Graphify-backed vault without exposing note bodies.

Local first

Agent work stays inspectable on your machine.

The trace belongs next to the local vault and generated graph output, so humans can see what an agent touched before trusting memory changes.

Review loop

Activity becomes a map for review.

File events make closeouts and memory proposals easier to audit: what was read, what changed, and what deserves to be remembered.

Already running Graphify? Open your graph natively.

Requirements: macOS, a Markdown/Obsidian vault, and Graphify output in it (run Graphify once first).

BrainBar reads local Graphify output from your vault. It does not upload your vault, rewrite Markdown, or treat generated graph files as the canonical source.

The script configures BrainBar locally. It expects Graphify output in the vault and keeps Markdown as the canonical source.

Latest releasev0.9.81
AssetBrainBar.dmg
PublishedJune 16, 2026
Install script
curl -fsSL https://raw.githubusercontent.com/Nova1390/brain-bar/main/install.sh | bash
Prefill vault path
BRAIN_BAR_VAULT_PATH="/path/to/your/vault" curl -fsSL https://raw.githubusercontent.com/Nova1390/brain-bar/main/install.sh | bash
Works with Obsidian

Works with Obsidian, not against it.

Obsidian stays your writing surface — the canonical Markdown you own. BrainBar adds the layer it doesn't have: a live, observable view of what your AI agent reads, writes, and remembers across your vault.

How it works

How BrainBar fits into the Graphify workflow.

Your Markdown or Obsidian vault remains the source. Graphify generates graph output. BrainBar opens that output as a native macOS workspace for search, focus, path tracing, and review.

01

Canonical source

Markdown / Obsidian vault

The local vault remains the canonical source: notes, links, tags, frontmatter, and project context.

02

Required generated layer

Graphify output

Required graph data lives in graphify-out, including graph.json and graph.html. BrainBar reads this generated layer.

03

macOS workspace

BrainBar explorer

A native macOS graph workspace for inspecting, searching, focusing, and navigating the generated graph.

04

Human control layer

Review + closeout loop

Agent activity and closeouts help humans see what changed and decide what deserves to be remembered.

01Capture in Markdown

The vault remains the canonical source for notes, links, tags, frontmatter, and project context.

02Run Graphify

Graphify generates graphify-out data, including graph.json and graph.html.

03Open in BrainBar

BrainBar reads the generated output as a native macOS graph workspace.

04Search / focus / trace / review

Humans inspect paths, neighborhoods, review checks, and activity around the generated graph.

05Close out durable findings

Stable outcomes become curated notes, decisions, and reviewable memory proposals.

Compatibility boundary
BrainBar requires Graphify output.

Obsidian is optional — any Markdown vault works as the source once Graphify has generated the local graph layer.

A companion skill for Obsidian-style closeouts.

BrainBar explores Graphify output. The obsidian-memory-closeout skill is a separate companion workflow for turning meaningful agent sessions into curated notes, decisions, and reviewable memory proposals.

View skill on GitHub
Live
Companion skillobsidian-memory-closeout

Turns meaningful AI work sessions into curated Obsidian-style notes, project updates, decisions, and reviewable memory proposals.

01
Product principleCurated memory only

The skill preserves durable outcomes and next actions, not raw transcripts, secrets, or noisy session debris.

02
Coming nextPublic examples

Small public-safe examples will show what a closeout saves, what it ignores, and what remains reviewable.

Memory Journal

Rocco's notes on agent memory, written with agents.

By Rocco D'Affuso / @rodabuilds.

Agents help draft and pressure-test the memos; Rocco curates and publishes them. The journal covers Graphify-powered graphs, review loops, closeouts, and human control without exposing private vault content, raw reasoning, or transcripts.

Open memo console

Local by default. Public by choice.

Local vaultMarkdown or Obsidian files

Your Markdown or Obsidian files stay on your machine.

Graphify outputgraphify-out/graph.json

BrainBar reads generated local graph files from graphify-out.

Public examplesSynthetic demo data

Demo graph data is public-safe and synthetic.

Never publicSecrets, private note bodies

No local paths, raw transcripts, or raw reasoning are published.

Technical FAQ

Precise answers for crawlers, agents, and humans.

Does BrainBar generate graphs?

No. BrainBar reads existing Graphify output from a local Markdown or Obsidian vault. Run Graphify first so graphify-out graph files exist; BrainBar opens that generated layer as a native macOS workspace.

Is Graphify required?

Yes. Graphify output is required for BrainBar. Markdown remains canonical, Graphify creates the generated graph layer, and BrainBar explores that output locally.

Does BrainBar upload my vault?

No. BrainBar reads local Graphify output and activity metadata on your machine. Public examples on brainbar.io use synthetic or curated public-safe data.

Does BrainBar require Obsidian?

No. Obsidian is optional. Any Markdown vault can be the canonical source once Graphify has generated the local graph output BrainBar needs.

What does Agent Activity track?

Agent Activity tracks metadata-only file events such as reads, writes, created notes, focus changes, closeouts, and decisions. It does not store note contents, prompts, secrets, or raw reasoning.