v4.0.0
De editor waar agents leven.
v4.0 is de major release voor agent-native author. Agents zijn van "externe CLI die af en toe wordt aangeroepen" gepromoveerd tot eersteklas burgers binnen de editor — continu aanwezig, werkend over meerdere vaults heen, volledig zichtbaar, reproduceerbaar, omkeerbaar. Alles hieronder zit in de core, geen plugin nodig. De installer is nog steeds ~15 MB.
Vijf pijlers
Elk van hen zit in de core en is in instellingen aan/uit te zetten. Volledig compatibel met je bestaande notities — geen DB-migratie, geen nieuw bestandsformaat, geen verplicht cloud-account.
1 · Ingebouwd Agent-paneel
Eersteklas paneel rechts, op gelijke voet met Outline / Backlinks /
Tags / History. Gestreamde chat-with-vault via een in-process MCP-interface
en de bestaande 14-provider AI-stack. [[wikilink]]-citaties
lossen op naar echte notitie-jumps; elke tool-call kaart van de agent
klapt uit in de gespreksstroom — zie wat er is gelezen, wat er is
geschreven. Antwoord te lang?
Insert- en Copy-knoppen droppen
de hele paragraaf in de huidige editor — vervangt de selectie als die
er is, voegt anders in op de cursorpositie. Run-geschiedenis blijft
bewaard als gewone markdown onder .solomd/agent-runs/,
grep-baar, git-trackbaar.
2 · Agent Recipe / geplande uitvoering
Declaratieve agent-jobs, YAML-bestanden onder
<workspace>/.solomd/agents/*.yml.
Triggers: schedule (cron), on-save,
on-commit, on-tag-add, handmatig.
Niet-onderhandelbare veiligheidsguardrails: elke run
vertrekt op zijn eigen AutoGit-branch
agent/<recipe>/<run-id>, alle schrijfacties
landen alleen op die branch, gaan via een accept/reject UI vóór de merge naar main;
write-cap per run (standaard 5, harde limiet 50)
voorkomt op hol geslagen loops; Reject hard-delete de branch, die
run is volledig onzichtbaar in de git-geschiedenis. Wordt geleverd met
11 Recipe-templates (wekelijkse review, log-opschoning,
TODO-extractie, vertaling, citation-cleanup, CJK-review,
…) — installeren, prompt aanpassen, draaien.
3 · Agent Trace-weergave
Elke run (zowel Panel-conversatie als Recipe) genereert
trace.jsonl, één regel per stap:
prompt / model_call /
tool_call / tool_result /
git_commit / done.
Stapkaarten klappen uit om args, resultaten, tokenaantallen,
kostenschattingen en AutoGit branch-referenties te tonen.
De Replay-from-step-knop spoelt de run terug naar stap N,
wisselt input en voert vanaf daar opnieuw uit — dat is de ingang naar
self-correcting recipes. Nieuwe MCP-tool
read_agent_trace(run_id) exposeert de trace aan andere agents.
4 · Multi-vault MCP-federatie
solomd-mcp --workspace path1 --workspace path2 --workspace path3
—— één MCP-sessie, meerdere vaults. Tool-signatures kregen een
optionele workspace-parameter, default = de eerste die
wordt meegegeven (volledig back-compat met single-vault MCP-clients).
AutoGit-branches zijn per workspace geïsoleerd. Instellingen → Integraties
heeft een MCP profile-UI: meerdere benoemde vaults bundelen,
Claude Desktop config-snippet kopiëren met één klik.
5 · Eersteklas Ollama
We bundelen niet zelf de lokale LLM-runtime
—— Ollama doet dat al goed. v4.0 heeft de integratie alleen verfijnd:
auto-detectie op localhost:11434 (Instellingen → AI heeft
een groene status-indicator), eenklik-installatiebegeleiding als niet
geïnstalleerd, 3 ingebouwde model-presets (rewrite → qwen2.5:7b ·
quick → qwen2.5:1.5b ·
cjk → qwen2.5:14b), aanbevolen pull inline wanneer de
modellijst leeg is. Recipes kunnen provider: local specificeren
(Ollama-alias) voor automatiseringsloops zonder cloudkosten.
Je notities verlaten nooit de machine —— via BYOK met Ollama
was dit altijd al waar; v4.0 maakt het een vindbare ingang.
🛡️ Veiligheidsguardrails (wat niemand anders doet)
- AutoGit branch-sandbox. Elke Recipe-run begint op
zijn eigen branch. Voordat je op Accepteren klikt, beweegt
mainniet. Reject-runs laten niets achter —— branch verwijderd, file tree teruggespoeld. - Schrijfplafond per run. Wil het model 50 bestanden schrijven terwijl de cap 5 is, dan wordt vanaf de 6e tool-call geweigerd. Geen "half-klare" state, geen accidenteel massa-edits.
- Weigert te starten als de workspace dirty is. Heb je niet-gecommitte wijzigingen en gaat de Recipe-trigger af, dan wordt er met een fout afgebroken; je WIP wordt niet meegeveegd in agent-commits.
- Path-traversal hardening. De in-process tool-interface
en alle Tauri-commands die door de gebruiker geleverde
run_id/pathaccepteren, weigeren nu vroegtijdig..-segmenten en absolute paden. Op codeniveau kan de agent niet buiten de workspace schrijven. - Reproduceerbare trace. Elke stap landt regel voor regel als JSON op disk. Verdacht Panel-gedrag? Volg de trace, lokaliseer de slechte stap, wissel input, replay vanaf stap N–1.
Quality bar
- First-run wizard. Nieuwe gebruikers zien het Agent-paneel binnen 60 seconden —— hij begeleidt je om een BYOK-sleutel in te voeren of Ollama te installeren. Open later opnieuw vanuit Help.
- Recipe Cookbook (11 starter-templates). Instellingen → Recipes → Cookbook bladeren. Wekelijkse review, dagelijks log, TODO-extractie, vertaal-pass, citation cleanup, CJK-review-agent, link-rot-detector, frontmatter-normalizer, outline-naar-blog, refactor-pass, wekelijkse tag-triage. Installeren, prompt aanpassen, draaien.
- Lokale REST-API (luistert alleen op localhost, token-authenticatie). Zelfde interface als MCP, voor clients die nog geen MCP spreken — Alfred / Raycast / n8n / je eigen scripts.
- BYOK kostenmeter. Cumulatief verbruikte tokens per provider, opt-in. Instellingen → Integraties.
- Lokalisatie. 9 UI-talen volledige dekking (en/zh/ja/ko/de/fr/es/pt/it). Deze release voegde 5 Europese talen toe — Duits, Frans, Spaans, Portugees, Italiaans — allemaal met dezelfde woordenboek-key-pariteit als en/zh.
UX-polish die je vanaf dag één voelt
- IME-guards overal. Chinees pinyin, Japanse kana-modus, Koreaans hangul — Enter om kandidaat-woorden te bevestigen triggert niet meer per ongeluk gespreksverzending / bestand-tree-rename / commando-palet uitvoering / zoekvenster openen. Eén fix voor 7 invoerpanelen.
- Insert / Copy-knoppen voor Assistant-antwoorden. Twee knoppen onder elk afgerond antwoord. Insert is editor-selectie-aware (met selectie vervangt het), zonder selectie wordt op de cursorpositie ingevoegd. Copy is normaal clipboard-gedrag.
- macOS opstart-UX. Activatie-timing bij opstart gefixt —— SoloMD koud opstarten brengt het echt naar de voorgrond, het verstopt zich niet meer achter Finder. Vensterpositie-herstel landt altijd in de workspace van het huidige scherm; herstel vanuit een slechte cache na het loskoppelen van een tweede scherm centreert zich automatisch opnieuw, in plaats van off-screen te openen.
- "Genereren..." vastgelopen zonder error. Gefixt. Provider-configfouten (bijv. Ollama met niet-gedownload model) lieten het paneel hangen. Nu zie je een rode foutbalk met de echte backend-respons, en de verzendknop komt ook terug.
Wat v4.0 expliciet niet doet (en waarom)
Nee zeggen is ook deel van het product. Deze zijn serieus overwogen en expliciet niet gedaan:
- Onze eigen lokale LLM-runtime meeleveren. Ollama doet dat al goed; het wiel opnieuw uitvinden schendt het principe "schrijf zo min mogelijk code die we permanent moeten onderhouden". BYOK-providers blijven het pad.
- Online Recipe-marketplace. Server-operatie + content-moderatie = afdwalen van de hoofdlijn. Cookbooks worden direct in de releases gebundeld, mee-geüpdatet met de tool.
- Multi-user / team-agents. Schendt "één venster, één schrijver". Dit product is voor een solo-auteur; samenwerking hoort bij een ander product thuis.
- Copilot-stijl ghost-text completion. Andere brand-positionering. Ghost-text verdunt de stem van de schrijver; onze agents werken in vault-eenheden, schrijfacties zijn batch + reviewbaar + branch-based.
Upgrade-notities
- Geen wijziging in bestandsformaat. Bestaande
.md-bestanden, AutoGit-geschiedenis, sync-config en BYOK-sleutels blijven ongewijzigd. - Agent-paneel staat automatisch aan bij eerste run.
Gebruikers van v3.6.x kunnen een verborgen
showAgentPanel: falsehebben door een scaffold-default uit de v4-beta-periode; een eenmalige migratie zet het op true zodat je de hoofdfunctie ook echt ziet. Wil je het niet, zet het uit via⌘⇧P → View: Toggle Agent Panel. - Het Instellingen-paneel heeft twee nieuwe tabs Recipes en Kostenmeter, onder Integraties. Bestaande instelling-locaties zijn ongewijzigd.
- De MCP-server (
solomd-mcp) heeft een nieuwe parameter--workspace(herhaalbaar) gekregen. Bestaande single-workspace MCP-clients blijven werken; federatie-gedrag is opt-in.
🔮 Wat komt hierna
5 hoofdpijlers + quality bar zijn deze keer de hoofdcontent. De openstaande richtingen voor v4.x en daarna staan allemaal in de roadmap: gesandboxte script-API, CLI v2 (rewrite / commit / semantisch zoeken / Recipe-trigger in de terminal), en de altijd uitgestelde vraag "Moet SoloMD een commercieel product worden?" (betaalde sync — oude vraag uit het v3.0-tijdperk, nog steeds niet beantwoord; totdat dat is besloten, wordt op dit terrein geen engineering verricht).
Bedankt aan iedereen die in de stille periode issues heeft ingediend / PR's heeft gestuurd / v4-beta builds heeft gedraaid op echte vaults. v4.0 kon worden geshipt omdat dogfooding de bugs ontdekte die de integratietests misten. Eerdere versies: Bekijk de blog (en) →