AI Mind Mapping
brain-map-skill
Turn a folder of Markdown notes into a single self-contained HTML knowledge map with a themed force-directed graph, scrubable growth timeline, and click-to-inspect panel.
brain-map-skill
What is brain-map-skill?
brain-map-skill is a tool that converts a folder of Markdown notes into an interactive HTML file containing a knowledge map. It reads YAML frontmatter for tags and dates, resolves wikilinks to create edges, and visualizes the graph with themes, node shapes, and a timeline that can be scrubbed or animated.
How to use brain-map-skill?
- 1Clone the repository.
- 2Run python3 scripts/build_map.py <notes_dir> out.html --title 'My Second Brain'.
- 3Open out.html in a browser.
- 4Alternatively, open the prebuilt demo demo/brain-map.html for instant exploration.
brain-map-skill Key Features
- Force-directed graph with theme coloring
- Growth timeline with scrub and play animation
- Click-to-inspect node details panel
- Filter by theme and type with live counts
- Search highlights matching nodes
- Responsive design for desktop and mobile
- Works with Obsidian vaults and gbrain exports
- Prebuilt demo included with 992 fictional notes
- Optional dependencies for pre-computed layout
brain-map-skill Use Cases
- Visualize a personal knowledge base or second brain
- Explore connections between notes in an Obsidian vault
- Present research or project documentation as an interactive map
- Embed as a static HTML for team knowledge sharing
brain-map-skill Pricing & Free Credits
brain-map-skill currently operates on a Free model.
brain-map-skill Pros & Cons
Pros
- No setup required with included prebuilt demo
- Works with standard Markdown and Obsidian vaults
- Self-contained HTML output that runs entirely in the browser
- Pre-computed layout option for large maps (optional dependencies)
Cons
- Requires Python to build from own notes
- No built-in server for additional features
- Limited to plain Markdown, no embedding or external data
What is brain-map-skill best for?
- Knowledge workers using Obsidian
- Developers creating interactive documentation
- Second brain enthusiasts
- AI agent integrators (Claude Code, Codex, etc.)