OBSIDIAN · PLUGIN · TYPESCRIPT
Repo Notebook voor Obsidian
Een Obsidian-plugin die je Repo Notebook-plank in je eigen vault zet: elke opgeslagen GitHub-repo wordt een notitie, verwante repos worden wikilinks, en klonen, installeren en starten blijven één commando ver.
RESULTAAT
Je hele GitHub-verzameling als gelinkte notities in Obsidian, in twee richtingen gesynchroniseerd met de app.
01 HET PROBLEEM
Repo Notebook bewaarde mijn GitHub-verzameling in een eigen app, maar mijn notities staan in Obsidian. Twee plekken betekent dubbel werk: wat je over een repo weet, hoort naast de rest van je kennis te staan, doorzoekbaar en linkbaar, zonder dat het uit sync loopt.
02 WAT HET DOET
- Elke repo een notitie
- Per repo een Markdown-notitie met frontmatter (sterren, taal, topics, status, cluster, gezondheid), een samenvatting, het AI-oordeel, de belangrijkste bestanden en de README. Plus een index-notitie per cluster en status.
- Verwante repos als wikilinks
- De koppelingen uit de kennisgraaf van de app worden echte [[wikilinks]], met de reden erbij. Zo toont de grafiekweergave van Obsidian je volledige repo-kaart. Tags zoals #repo/taal/python geven kleurgroepen.
- Sync in twee richtingen
- Pas je status, categorie of notities aan in Obsidian, dan staat dat ruim een seconde later in de app, en omgekeerd. Jouw eigen Notities-blok wordt nooit overschreven; een verwijderde repo wordt gemarkeerd, niet gewist.
- Zijpaneel met acties
- Zoeken, statusfilters, een A–Z-lijst en een rechtsklikmenu met klonen, installeren, starten, stoppen, log en git pull. Staat de app uit, dan werken lezen, sync en repos toevoegen gewoon verder.
- Bases-tabel
- Een kant-en-klare tabel voor Obsidian Bases: alle repos, ‘te proberen’, ‘gekloond’ en een weergave per cluster.
- Installeren in 3 stappen
- Installeer BRAT uit de community-plugins, kies ‘Add beta plugin’ en plak TMSHuybrechts/obsidian-repo-notebook. BRAT houdt de plugin daarna zelf up-to-date.
03 WAT IK ERVAN LEERDE
De lastigste vraag was niet technisch maar: wat is van wie? Zodra vastlag welk deel van een notitie de app beheert en welk deel van jou is, werd sync in twee richtingen betrouwbaar. De kernlogica draait zonder Obsidian en is getest tegen een kleine nep-versie van de Obsidian-API; een sync van 122 repos duurt zo'n 0,3 seconde.
INTERESSE?
Laten we praten.
Vertel me wat je ervan vindt — of wat je ermee zou willen doen.