GitHub - vladignatyev/brain-map-skill: Interactive HTML knowledge map from a folder of Markdown notes (Obsidian/gbrain) — themed force graph + growth timeline. Ships a prebuilt demo. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
vladignatyev
brain-map-skill
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>4 Commits<br>4 Commits
demo
demo
scripts
scripts
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
SKILL.md
SKILL.md
index.html
index.html
requirements.txt
requirements.txt
View all files
Repository files navigation
brain-map
Turn a folder of Markdown notes (an Obsidian vault or a gbrain export) into one<br>self-contained, interactive HTML knowledge map — a force-directed graph coloured by<br>theme, a timeline you can scrub to watch the base grow, and a click-to-inspect panel.
Works with: Claude Code · OpenAI Codex · Cursor · Gemini CLI · OpenClaw · or just run the script.
See it in 5 seconds (no setup)
A prebuilt demo ships in this repo — no notes to generate, no embeddings, no gbrain,<br>no Python. Open the file:
open demo/brain-map.html # macOS<br>xdg-open demo/brain-map.html # Linux<br>start demo/brain-map.html # Windows
992 fictional notes across three themes (work · study · life ). Scrub the timeline,<br>press ▶ Play growth , click nodes, toggle filters.
Build from your own notes
out.html --title "My Second Brain"<br>open out.html">python3 scripts/build_map.py notes_dir> out.html --title "My Second Brain"<br>open out.html
= your Obsidian vault, or a gbrain export --dir directory. The map<br>reads plain Markdown: YAML frontmatter (tags, created) + [[wikilinks]].
Dependencies are optional
Setup<br>Result
Nothing (stdlib Python only)<br>Builds anywhere; the browser computes the layout (Cytoscape cose).
pip install -r requirements.txt (networkx, numpy, scipy)<br>Layout pre-computed → 1000-node maps open instantly and look cleaner.
The builder auto-detects networkx and picks the better path. No gbrain, no embeddings,<br>no server required either way.
What it reads
Theme = top-level folder (Work/, Study/, Life/) → node & edge colour.
Type = subfolder / tags → node shape (person, meeting, journal, lecture, project,<br>link, todo, index, note).
Edges = resolved [[wikilinks]]. Node size scales with link count; hubs get labels.
Timeline = created timestamps, bucketed by month, stacked by theme.
The richer your cross-linking (people cards, meeting attendees, index pages), the more<br>legible the map. Designed to pair with the save-note<br>skill, which writes exactly this shape.
In the HTML
Scrub / Play the timeline → the graph reveals notes up to that month; Play animates<br>the whole base growing from empty to today.
Filter by theme and type (live counts); search highlights matches.
Click a node → dim the rest, light its neighbourhood, open a detail panel (summary,<br>tags, date, connected notes).
Responsive down to a phone.
Install as an agent skill
Claude Code
git clone https://github.com/vladignatyev/brain-map-skill ~/.claude/skills/brain-map
OpenAI Codex
git clone https://github.com/vladignatyev/brain-map-skill ~/.agents/skills/brain-map
Cursor / others — paste SKILL.md into your agent's instructions; it's self-contained.
Regenerate the demo corpus
python3 scripts/generate_demo_notes.py /tmp/demo-vault # 992 invented notes<br>python3 scripts/build_map.py /tmp/demo-vault demo.html
All demo people, orgs and events are fictional — no real data.
Layout
brain-map-skill/<br>├── SKILL.md # agent skill spec<br>├── scripts/<br>│ ├── build_map.py # the builder (Markdown dir → interactive HTML)<br>│ └── generate_demo_notes.py # writes the fictional demo vault<br>├── demo/<br>│ ├── brain-map.html # PREBUILT — open it, zero setup<br>│ ├── vault/ # 992 source Markdown notes<br>│ └── preview.png<br>├── requirements.txt # optional: networkx, numpy, scipy<br>└── LICENSE
License
MIT
About
Interactive HTML knowledge map from a folder of Markdown notes (Obsidian/gbrain) — themed force graph + growth timeline. Ships a prebuilt...