Skip to content

Guides and resources for AI engineers: an agents course, five handbooks, a hands-on second-brain project and a vetted reading list.

1.2 KB
Raw Blame

scripts

Small, dependency-free Python scripts. Everything here reads the vault as plain files, so nothing breaks if you switch editors or agents.

Script What it does
link_check.py Broken wikilinks, orphan pages, stubs
vault_stats.py Page counts, link density, orphan rate, most-linked pages
graph_export.py Wikilink graph as CSV edges or GraphML for Gephi
chat_export_to_md.py Chat history export into per-conversation markdown
python3 scripts/vault_stats.py ~/brain
python3 scripts/link_check.py ~/brain
python3 scripts/graph_export.py ~/brain graph.graphml --format graphml

Copy the folder into the vault (cp -r scripts ~/brain/scripts, the Quickstart does this) so the /metrics, /health and /graph-export commands can find them. Hidden folders such as .claude/ and .obsidian/, templates/, scripts/, raw/, and any CLAUDE.md or README.md are skipped, so the counts describe your wiki, not the tooling around it. On Windows, python3 is usually the Microsoft Store stub; run these with python instead.

The agent can do all of this in natural language, but a script gives the same answer every time and costs nothing to run, which is what you want for anything you check weekly.