Turn a folder of Markdown notes (an Obsidian vault or a gbrain export ) into one self-contained, interactive HTML knowledge map — a force-directed graph coloured by 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, no Python. Open the file:
open demo/brain-map.html # macOS xdg-open demo/brain-map.html # Linux start demo/brain-map.html # Windows
992 fictional notes across three themes (work · study · life). Scrub the timeline, press ▶ Play growth, click nodes, toggle filters.
Build from your own notes
python3 scripts/build_map.py < notes_dir > out.html --title " My Second Brain " open out.html
<notes_dir> = your Obsidian vault, or a gbrain export --dir <out> directory. The map reads plain Markdown: YAML frontmatter ( tags , created ) + [[wikilinks]] .
Dependencies are optional
... continue reading