markdown vault โ†’ synthwave galaxy

A 3D cockpit
for your knowledge vault

Point it at a folder of markdown notes and fly through it โ€” then watch your AI agents light it up in real time: comet trails, retrieval chains, full-day replay, analytics.

install โ€” python 3.9+ is all you need 
# just looking? run the built-in 120-note demo โ€” no vault needed:
$ git clone https://github.com/chuong1224/agents-knowledge-base
$ cd agents-knowledge-base
$ python try_demo.py

# install into YOUR vault โ€” โš  replace YourVault with the path to your folder
#   of markdown notes (no vault yet? see "start from zero" below)
$ git clone https://github.com/chuong1224/agents-knowledge-base "YourVault/.graph3d"
$ cd "YourVault/.graph3d"
$ python ensure_graph3d.py
no pip ยท no npm ยท no build step ยท 127.0.0.1 only โ€” your notes never leave your machine
The vault rendered as a synthwave 3D galaxy โ€” tag groups form colored continents
Watch AI agents work โ€” live. Every read and edit an agent makes fires comet trails and hyperspace hops across the graph. Nothing your agents do is invisible anymore.
Replay a full day in seconds. Scrub the timeline like a video edit. Per-agent stats, hourly histograms, hottest notes โ€” retrieval, measured.
Zero dependencies. No build step. One Python-stdlib server, vanilla ES modules, vendored three.js. Clone, run, done โ€” and the test suite finishes in ~3 seconds.
Your vault stays plain markdown. No database of truth, no lock-in. Obsidian and this cockpit read the same files, forever.

No vault yet? Start from zero

The secret: a vault is just a folder of markdown files. No Obsidian required, no account, nothing to import.

๐ŸŽฎ

1 ยท Feel it first

python try_demo.py opens the 120-note demo galaxy โ€” the one in every shot on this page. Zero setup.

๐ŸŒฑ

2 ยท Grow your own

Copy the repo's starter-vault โ€” 9 guided notes that teach notes, [[wikilinks]], tags and hubs by being read inside the app. Vietnamese summary included.

๐Ÿงญ

3 ยท Obsidian later, if ever

Any text editor works โ€” Notepad included, AI agents too. Obsidian is a great editor to adopt when you write daily; it opens the exact same folder.

Not just a graph โ€” a cockpit

Reader with wikilinks & backlinks ยท folder tree ยท Ctrl+P everything-search ยท tabs, split panes, pins

Full cockpit UI: markdown reader, folder tree, live agent feed and retrieval chains
๐ŸŒŒ

Synthwave 3D graph

Force-directed galaxy of notes, tags and files. Degree-aware physics, cluster magnet, collision guard, adjustable neon.

๐Ÿค–

Agent activity layer

Claude Code hook out of the box; any agent via one JSONL writer. Per-agent colors and replayable retrieval chains.

๐Ÿ”ฅ

Heatmaps

Recent-window and long-term cumulative access frequency โ€” your vault's hot zones glow and swell.

๐Ÿ–ฅ

Multi-machine

Per-host journals live in the vault. Machines syncing over OneDrive / Drive / Syncthing merge history automatically.

๐Ÿ›ก

Self-healing server

Single instance keyed by port, auto-restart on source change, stale-process cleanup โ€” and it never kills what it can't verify.

๐Ÿ“–

Reader & finder

Click a node to read the note. Quick switcher searches names, #tags and full text โ€” diacritic-insensitive.

Two agents, full throttle

Claude and Nova jumping non-stop across 120 notes โ€” comet trails, hyperspace hops, impact ripples. Live capture, no editing

Animated: two agents continuously jumping across the vault with comet trails and impact effects

The aftermath

Claude's blue and Nova's yellow trails woven across every continent of the vault

Agent trails lighting up the graph: Claude in blue, Nova in yellow

How it works

One Python file serves your vault as a living cockpit โ€” agents feed the activity layer

Architecture diagram: vault to Python server to 3D cockpit; agents feed the activity log