Scripts (Beta)

Laatst bijgewerkt: 2026-11-17

Een script is een klein programma voor wat een model slecht kan en een programma elke keer op dezelfde manier doet: tellen, sorteren, vergelijken, optellen. Je schrijft het in JavaScript. Het draait in een afgesloten ruimte binnen Plainva: het kan geen bestand openen, niet het netwerk op en niet wachten tot later. Het roept alleen de hulpmiddelen aan die je ervoor hebt aangevinkt: ze lezen je vault zoals de hulpmiddelen van de AI dat doen, of leggen een voorstel neer waarover jij beslist. Een script dat je hier start, verandert zelf niets; een script dat de AI in een gesprek start, kan direct schrijven waar je dat toestaat (zie ‘In een gesprek’ hieronder).

Een script uitvoeren

Je scripts staan onder Vaardigheden in het AI-tabblad — op de telefoon in het segment Vaardigheden van het scherm AI — in de groep Scripts. Uitvoeren opent het script: vul in wat het vraagt en druk op Uitvoeren. Zolang het draait, zie je elk hulpmiddel dat het aanroept, en Stoppen beëindigt het. Daarna toont het dialoogvenster de Aanroepen, het Resultaat — dat je kunt kopiëren — en het Logboek, en wat de uitvoering van zijn grenzen heeft verbruikt.

Een uitvoering die je hier start, blijft op dit apparaat: niets ervan gaat naar een model, dus het script leest ook notities die je van de cloud weghoudt. Proefrun roept de hulpmiddelen aan die lezen, en noteert alleen een aanroep die in de app iets zou tonen of een voorstel zou neerleggen.

In een gesprek

In een gewoon gesprek kan de AI je actieve scripts vinden en er een uitvoeren wanneer dat past; dan staat er als stap Voert het script “word-count” uit. Het script leest alleen wat dat gesprek mag lezen: een notitie die je van de cloud weghoudt, blijft weggehouden, en elke notitie die het script leest, telt mee bij wat de uitvoering heeft gelezen. Wat het teruggeeft, gaat als gegevens naar het model, nooit als instructies. Een routine, de testrun van een vaardigheid en de ingangen Afbeelding uitleggen en Er een notitie van maken voeren geen script uit, een gesprek dat met een vaardigheid is gestart, krijgt er geen aangeboden, en een AI-app die via de MCP-server is verbonden ook niet.

Wijzigingen voorstellen

Een script kan ook hulpmiddelen krijgen die voorstellen doen. Een voorstel in de marge van een notitie komt van de hulpmiddelen Stelt wijzigingen in een notitie voor en Stelt een eigenschapswaarde voor; een concept komt van de hulpmiddelen Maakt een concept van een notitie, Maakt een concept van een database-item, Maakt een concept van een taak en Maakt een concept van een journaalitem. Beide zijn ondertekend met de naam van het script. Een script dat je hier met Uitvoeren start, schrijft niets direct: in je vault verandert niets voordat je een voorstel overneemt of een concept aanmaakt — precies zoals bij een voorstel van de AI. Na een uitvoering somt het dialoogvenster ze op onder Voorstellen en concepten; een uitvoering die met Proefrun is gestart, laat niets achter.

Wat een script las, bepaalt waar het mag schrijven: een voorstel of een concept dat berust op een notitie die je van de cloud weghoudt, kan alleen terechtkomen op een plek waar dezelfde regel geldt. In een gesprek krijgt de AI een script dat voorstellen doet alleen aangeboden waar het gesprek zelf voorstellen kan doen, en wat het script daar neerlegt, is ondertekend met de naam van het model van het gesprek. Waar het gesprek wijzigingen direct toepast — met de chip Direct toepassen of voor een doel in een map die Wijzigen zonder te vragen toestaat —, wordt ook wat zo’n script schrijft direct toegepast: een wijziging aan een notitie en aan haar eigenschappen, een nieuwe notitie, een database-item, een taak of een journaalitem, met hetzelfde vangnet als de eigen directe wijzigingen van de assistent (zie ‘Direct toepassen’ in AI-assistent). Zo kan één run veel notities wijzigen: de AI mag in elke stap van zijn antwoord een script starten, en elke start mag zoveel aanroepen doen als de grens van het script toelaat. Elke wijziging bewaart haar versie van ervoor, en het antwoord noemt ze allemaal met Alles terugdraaien. Zonder die toestemming laat het script voorstellen en concepten achter, zoals hierboven.

Een script schrijven

Nieuw script vraagt om:

Maken en goedkeuren schrijft het script als .agent/scripts/<name>/ in je vault — een manifest.json en een main.js — en keurt het goed op dit apparaat. Bewerken in het menu van een script opent hetzelfde formulier; Opslaan en goedkeuren vervangt de bestanden.

De code is de romp van een functie. input bevat de invoer per naam, tools.<name>(…) roept een hulpmiddel aan en wordt afgewacht, return geeft het resultaat terug, en console.log(…) schrijft een regel in het logboek:

const found = await tools.search_vault({ query: "#" + input.tag, limit: 25 });
const notes = [];
for (const hit of found.results) {
  const note = await tools.read_note({ path: hit.path });
  if (note.text.includes("#" + input.tag)) notes.push(hit.path);
}
return { tag: input.tag, count: notes.length, notes };

De taal is actueel JavaScript — ES2024, met het meeste van ES2025 — zonder Intl. Er is geen fetch, geen timer, geen import en geen toegang tot bestanden, en wat een script teruggeeft, moet gegevens zijn die als JSON kunnen worden geschreven. Een hulpmiddel dat weigert — een notitie die niet bestaat, een notitie die het gesprek niet mag lezen — geeft een fout die het script kan opvangen.

Wat een hulpmiddel teruggeeft

Wat een hulpmiddel teruggeeft in het formulier opent deze pagina. Elk hulpmiddel neemt één object aan en geeft er één terug; cursor neemt de next van de voorgaande aanroep over en gaat verder met de lijst daarvan.

HulpmiddelJe geeft meeJe krijgt terug
search_vault — Doorzoekt de vaultquery; optioneel folder, limit (hoogstens 25), cursorresults: een lijst van { title, path, snippet }; next
read_note — Leest een notitiepath; optioneel section, maxChars (200 tot 20.000), cursorpath, text, next
get_outline — Leest de structuurpathpath; properties: naam en waarde; sections: een lijst van { level, text, section }
query_base — Leest een databasebase, het pad van het .base-bestand; optioneel view, limit (hoogstens 50), cursorbase, view, views; rows: een lijst van { title, path, properties }; next
get_tasks — Leest takenoptioneel range (today, upcoming, overdue, inbox, all, done), limit (hoogstens 50), cursortasks: een lijst van { state, title, due, priority, path, note, source }; next
get_backlinks — Backlinks lezenpath; optioneel limit (hoogstens 50), cursorpath; notes: een lijst van { title, path, links, places }; next
graph_neighborhood — Links volgenpath; optioneel depth (1 of 2), limit (hoogstens 50)path; notes: een lijst van { title, path, fromHere, toHere, via }
get_recent — Recente notities bekijkenoptioneel kind (opened of edited), limit (hoogstens 20)kind; notes: een lijst van { title, path, at }
get_changes — Wijzigingen bekijkensince als YYYY-MM-DD; optioneel until, folder, limit (hoogstens 20)since, until; notes: een lijst van { path, title, kind, made, last, added, removed, gained }
get_note_history — De ontwikkeling van een notitie volgenpath; optioneel since en until als YYYY-MM-DD, hoogstens 31 dagen uit elkaarpath, since, until, made; days: een lijst van { day, added, removed, gained }
get_calendar — Afspraken lezenfrom en to als YYYY-MM-DD, hoogstens 31 dagen uit elkaar; optioneel details, limit (hoogstens 100)events: een lijst van { day, start, end, allDay, title, cancelled, place, with, others, online, event }; more
run_command — Gebruikt de appid, een opdracht van de app zoals open-note, show-in-graph of open-calendar; optioneel args met path, section of datedone, command
propose_edit — Stelt wijzigingen in een notitie voorpath; edits, een lijst van { find, replace }, of append; optioneel section, noteproposed, path, passages
set_property — Stelt een eigenschapswaarde voorpath, key, value; optioneel noteproposed, path, property
create_note — Maakt een concept van een notitietitle, content; optioneel folderdrafted, kind, title
create_entry — Maakt een concept van een database-itembase, title; optioneel properties, contentdrafted, kind, title, base
create_task — Maakt een concept van een taaktextdrafted, kind, title
add_journal_entry — Maakt een concept van een journaalitemtext; optioneel taskdrafted, kind

Grenzen

Een script legt zijn grenzen vast in zijn manifest. Het formulier stelt er drie van in:

GrensStandaardBereik
Seconden rekentijd51 tot 30
Aanroepen van hulpmiddelen200 tot 50
Geheugen in MB328 tot 128

Alleen de tijd waarin een script rekent telt mee, niet de tijd die een hulpmiddel nodig heeft. Een script dat een grens overschrijdt — tijd, geheugen, stappen, het aantal aanroepen, de grootte van de argumenten van één aanroep of de grootte van het resultaat van het script zelf —, wordt beëindigd; het dialoogvenster zegt welke grens het was, en een beëindigd script geeft niets terug. Een antwoord van een hulpmiddel dat groter is dan de grens voor één aanroep, is geen einde: het script krijgt voor die aanroep een foutmelding en loopt door. Standaard mogen de argumenten van één aanroep, wat één aanroep teruggeeft en het resultaat elk hoogstens 64 KB groot zijn; een manifest mag tot 256 KB toestaan.

Niets draait voordat je het goedkeurt

Een script dat nieuw of gewijzigd is — via sync, of geschreven door een ander programma — draait pas wanneer je het op dit apparaat goedkeurt. Het wacht bovenaan in Vaardigheden onder Wachten op je goedkeuring. Controleren en goedkeuren toont Wat het mag, zijn Grenzen, zijn Invoer en de hele Code, en zegt of de code als JavaScript te lezen is; code die niet te lezen is, wordt niet goedgekeurd.

Met Goedkeuren ondertekent dit apparaat precies deze bestanden. De sleutel daarvoor wordt op dit apparaat gemaakt en staat in de sleutelhanger ervan. Elke wijziging aan een bestand heft de goedkeuring op, en op elk van je andere apparaten wacht het script op een eigen goedkeuring — een goedkeuring kan niet van het ene apparaat naar het andere worden meegenomen. Goedkeuring intrekken in het menu van een script maakt de goedkeuring ongedaan, en Code bekijken toont de controle opnieuw.

Grenzen van de beta

Een script stelt voor en zet concepten klaar, en schrijft alleen direct in een gesprek waarin je de assistent wijzigingen direct laat toepassen; het hernoemt, verplaatst of verwijdert nooit een notitie, en het stelt geen e-mail en geen afspraak op. Een vaardigheid kan geen script starten, en de eigen map scripts/ van een vaardigheid wordt niet uitgevoerd. E-mail, internet en de hulpmiddelen van externe servers zijn voor scripts niet beschikbaar.