{"slug": "show-hn-skill-for-your-agent-to-visualize-your-gbrain-and-obsidian", "title": "Show HN: Skill for your agent to visualize your gbrain and Obsidian", "summary": "A developer released an open-source tool that converts a folder of Markdown notes from Obsidian or gbrain into a single interactive HTML knowledge map with force-directed graph, timeline, and click-to-inspect panel. The tool works with AI coding agents like Claude Code and OpenAI Codex, and requires no embeddings or server.", "body_md": "Turn a folder of Markdown notes (an Obsidian vault or a\n\n`gbrain export`\n\n) intoone 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.\n\n**Works with:** Claude Code · OpenAI Codex · Cursor · Gemini CLI · OpenClaw · or just run the script.\n\nA prebuilt demo ships in this repo — **no notes to generate, no embeddings, no gbrain,\nno Python.** Open the file:\n\n```\nopen demo/brain-map.html        # macOS\nxdg-open demo/brain-map.html    # Linux\nstart demo/brain-map.html       # Windows\n```\n\n992 fictional notes across three themes (**work · study · life**). Scrub the timeline,\npress **▶ Play growth**, click nodes, toggle filters.\n\n```\npython3 scripts/build_map.py <notes_dir> out.html --title \"My Second Brain\"\nopen out.html\n```\n\n`<notes_dir>`\n\n= your Obsidian vault, or a `gbrain export --dir <out>`\n\ndirectory. The map\nreads plain Markdown: YAML frontmatter (`tags`\n\n, `created`\n\n) + `[[wikilinks]]`\n\n.\n\n| Setup | Result |\n|---|---|\nNothing (stdlib Python only) |\nBuilds anywhere; the browser computes the layout (Cytoscape `cose` ). |\n`pip install -r requirements.txt` (networkx, numpy, scipy) |\nLayout pre-computed → 1000-node maps open instantly and look cleaner. |\n\nThe builder auto-detects networkx and picks the better path. No gbrain, no embeddings, no server required either way.\n\n**Theme**= top-level folder (`Work/`\n\n,`Study/`\n\n,`Life/`\n\n) → node & edge colour.**Type**= subfolder / tags → node shape (person, meeting, journal, lecture, project, link, todo, index, note).** Edges**= resolved`[[wikilinks]]`\n\n. Node size scales with link count; hubs get labels.**Timeline**=`created`\n\ntimestamps, bucketed by month, stacked by theme.\n\nThe richer your cross-linking (people cards, meeting attendees, index pages), the more\nlegible the map. Designed to pair with the [save-note](https://github.com/vladignatyev/save-note-skill)\nskill, which writes exactly this shape.\n\n**Scrub / Play** the timeline → the graph reveals notes up to that month; Play animates 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, tags, date, connected notes).- Responsive down to a phone.\n\n**Claude Code**\n\n```\ngit clone https://github.com/vladignatyev/brain-map-skill ~/.claude/skills/brain-map\n```\n\n**OpenAI Codex**\n\n```\ngit clone https://github.com/vladignatyev/brain-map-skill ~/.agents/skills/brain-map\n```\n\n**Cursor / others** — paste `SKILL.md`\n\ninto your agent's instructions; it's self-contained.\n\n```\npython3 scripts/generate_demo_notes.py /tmp/demo-vault   # 992 invented notes\npython3 scripts/build_map.py /tmp/demo-vault demo.html\n```\n\nAll demo people, orgs and events are fictional — no real data.\n\n```\nbrain-map-skill/\n├── SKILL.md                      # agent skill spec\n├── scripts/\n│   ├── build_map.py              # the builder (Markdown dir → interactive HTML)\n│   └── generate_demo_notes.py    # writes the fictional demo vault\n├── demo/\n│   ├── brain-map.html            # PREBUILT — open it, zero setup\n│   ├── vault/                    # 992 source Markdown notes\n│   └── preview.png\n├── requirements.txt              # optional: networkx, numpy, scipy\n└── LICENSE\n```\n\n", "url": "https://wpnews.pro/news/show-hn-skill-for-your-agent-to-visualize-your-gbrain-and-obsidian", "canonical_source": "https://github.com/vladignatyev/brain-map-skill", "published_at": "2026-06-13 06:43:42+00:00", "updated_at": "2026-06-13 06:53:51.310007+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-tools"], "entities": ["Obsidian", "Claude Code", "OpenAI Codex", "Cytoscape", "networkx", "numpy", "scipy", "gbrain"], "alternates": {"html": "https://wpnews.pro/news/show-hn-skill-for-your-agent-to-visualize-your-gbrain-and-obsidian", "markdown": "https://wpnews.pro/news/show-hn-skill-for-your-agent-to-visualize-your-gbrain-and-obsidian.md", "text": "https://wpnews.pro/news/show-hn-skill-for-your-agent-to-visualize-your-gbrain-and-obsidian.txt", "jsonld": "https://wpnews.pro/news/show-hn-skill-for-your-agent-to-visualize-your-gbrain-and-obsidian.jsonld"}}