Wat is een recipe (v4)?
Een YAML-bestand onder <workspace>/.solomd/agents/*.yml. Eén bestand = één agent-job. Verplichte velden: name, trigger (schedule | on-save | on-commit | on-tag-add | manual), prompt. Optioneel: schedule (cron), match (glob), allow-write, write-cap, provider, model, allowlist tools. SoloMD levert 11 starters in Instellingen → Recipes → Cookbook bladeren — installeer er een, pas aan, voer uit. Het volledige schema staat in docs/agents.md.
Zijn agent-writes veilig?
Elke recipe-run begint met een branch vanuit main: agent/<recipe>/<run-id>. Schrijfacties landen alleen op die branch. Bij succes gaat de run naar Pending — bekijk de diff en klik op Accepteren (fast-forward naar main) of Weigeren (verwijdert de branch volledig). Een geweigerde run laat geen sporen achter in je geschiedenis. Schrijfacties hebben ook een per-run cap (standaard 5, harde limiet 50) — een model dat 100 bestanden wil schrijven terwijl de cap 5 is, krijgt vanaf de 6e call een refusal, geen half-toegepaste state.
Hoe verschilt dit van Cursor's ghost-text of Copilot?
Cursor en Copilot zijn uitstekend voor toetsenbord-niveau code-completion. SoloMD-agents zijn op drie manieren anders: (1) de werkeenheid is de *vault*, niet de cursor — agents lezen door notities heen via wikilinks, backlinks, full-text search en tags; (2) schrijfacties zijn batch + reviewbaar, geen ghost-text die je inline accepteert; (3) agents kunnen op schema draaien terwijl je niet aan het toetsenbord zit (wekelijkse review, dagelijkse samenvatting, on-tag triage). Het zit dichter bij Cursor's Agent / Composer-modus dan bij inline-completion — en het is expliciet geen schrijfstijl-completion (we vinden dat ghost-text de stem van de schrijver verdunt).
Hebben recipes een API-key nodig?
Alleen als de recipe een cloud-provider specificeert. Voor provider: ollama (of de alias local) is geen sleutel nodig — qwen2.5:1.5b draait gratis op je eigen machine. Voor provider: claude / openai / gemini / etc. heb je de sleutel van die provider nodig in Instellingen → AI (BYOK). De first-run wizard begeleidt je door beide paden.
Hoe verschilt SoloMD's semantische zoeken van grep?
Grep matcht karakters; semantisch zoeken matcht betekenis. Zoek op "deployment" en je vindt mogelijk ook paragrafen over "rolling out", "shipping", "release". De embedder draait volledig in ons Rust-proces — geen download van modelbestanden, geen netwerkaanroepen, geen cloud. Standaard uit; zet de toggle in Instellingen om opt-in. De index leeft in <workspace>/.solomd/embeddings.sqlite (automatisch gitignored).
Is SoloMD echt gratis?
Ja. SoloMD is open-source software onder MIT-licentie. Er is geen betaalde tier, geen account, standaard geen telemetrie, geen advertenties. Als het je schrijven helpt, kun je de ontwikkelaar sponsoren, maar je bent nooit verplicht.
Waar staan API-sleutels voor de 14 AI-providers?
In je OS-keychain — Apple Keychain op macOS, Credential Manager op Windows, libsecret op Linux. Nooit in localStorage, nooit in een config-bestand dat SoloMD schrijft. AI-requests gaan rechtstreeks van je machine naar de provider die je hebt gekozen; SoloMD host geen modellen en relayt geen verkeer.
Hoe groot is de installer?
Ongeveer 10–15 MB afhankelijk van het platform. Dat is ongeveer 6× kleiner dan Typora en 7× kleiner dan Obsidian, omdat SoloMD Tauri (system webview + Rust) gebruikt in plaats van Chromium te bundelen.
Werkt het offline?
Ja, volledig. De editor zelf doet nul netwerkaanroepen. Semantisch zoeken is alleen lokaal. AutoGit commit naar een lokale repo en pusht nooit automatisch. Het enige uitgaande verkeer is (1) de optionele controle op release-updates op GitHub bij het opstarten (uit te zetten in Instellingen) en (2) AI-rewrite calls die jij expliciet activeert, die rechtstreeks naar de provider gaan die je hebt gekozen.
Hoe werkt de MCP-server?
Een enkele 1,5 MB sidecar binary (solomd-mcp) spreekt het Model Context Protocol via stdio — geen netwerkpoort. Wijs Claude Desktop, Cursor of een willekeurige MCP-client naar je workspace en je krijgt 8 leestools (list_notes, read_note, search, get_backlinks, list_tags, get_outline, etc.) plus 2 schrijftools achter --allow-write. Pad-traversal beschermd, workspace-canonical containment.
Hoe gaat SoloMD om met niet-UTF-8 bestanden zoals GBK / Big5?
SoloMD detecteert de encoding automatisch met de Rust-crate chardetng wanneer je een bestand opent. UTF-8, UTF-16 LE/BE (met of zonder BOM), GBK, GB18030, Big5, Shift_JIS en vele andere worden herkend en correct weergegeven.
Kan ik mijn notities synchroniseren met andere apparaten?
Nog niet — ingebouwde CRDT-sync staat op de v3-roadmap. Voor nu werkt SoloMD prima met iCloud Drive, Dropbox, OneDrive, Syncthing of elke folder-based sync-tool. Bewaar je notities gewoon binnen een gesynchroniseerde map. Of gebruik AutoGit + handmatig pushen naar GitHub.
Waarom zijn er geen plugins?
SoloMD laat een plugin-systeem bewust achterwege om lichtgewicht, stabiel en auditeerbaar te blijven. De features die serieuze schrijvers vragen — semantisch zoeken, versiegeschiedenis, AI-rewrite, plak afbeelding, KaTeX, Mermaid, focus-modus, custom CSS — zitten allemaal in de core.
Waarom verscheen "Windows heeft je pc beveiligd" bij de eerste start?
SoloMD is een klein open-source project dat nog geen reputatie heeft opgebouwd in Microsoft SmartScreen. Klik op "Meer informatie → Toch uitvoeren" één keer en het zal het je niet opnieuw vragen. We werken aan een code-signing certificaat.
Hoe open ik .md-bestanden standaard met SoloMD?
Rechtsklik op een .md-bestand → Openen met → SoloMD → vink "Altijd deze app gebruiken" aan. De gebundelde installer registreert SoloMD als handler voor de extensies .md, .markdown, .mdown, .mkd en .txt.
Wat is het verschil tussen SoloMD en Obsidian?
Obsidian is een knowledge-management-tool met vaults, wiki-links, backlinks, graph-view en plugin-marketplace. SoloMD is een lichtgewicht editor om Markdown-bestanden te schrijven — maar levert wel een paar dingen die Obsidian niet heeft (semantisch zoeken in de core, AutoGit, MCP-server, 14 AI-providers in één paneel). Gebruik Obsidian als je een second brain met plugin-marketplace wilt; gebruik SoloMD als je de schrijftools zonder plugin-tax wilt.