Skripte (Beta)

Stand: 2026-11-17

Ein Skript ist ein kleines Programm für das, was ein Modell schlecht kann und ein Programm jedes Mal gleich macht: zählen, sortieren, vergleichen, zusammenrechnen. Du schreibst es in JavaScript. Es läuft in einem geschlossenen Kasten in Plainva: es kann keine Datei öffnen, nicht ins Netz und nicht auf später warten. Es ruft nur die Werkzeuge auf, die Du ihm angekreuzt hast: sie lesen Deinen Vault so, wie die Werkzeuge der KI es tun, oder hinterlassen einen Vorschlag, über den Du entscheidest. Ein Skript, das Du hier startest, ändert von sich aus nichts; eines, das die KI in einem Gespräch startet, kann direkt schreiben, wo Du es zulässt (siehe „In einem Gespräch“ weiter unten).

Ein Skript ausführen

Deine Skripte stehen unter Skills im KI-Tab — am Telefon auf dem KI-Bildschirm bei den Skills — in der Gruppe Skripte. Ausführen öffnet das Skript: trag ein, wonach es fragt, und drück Ausführen. Während es läuft, siehst Du jedes Werkzeug, das es aufruft, und Stopp beendet es. Danach zeigt der Dialog die Aufrufe, das Ergebnis — das Du kopieren kannst — und das Protokoll, dazu, was der Lauf von seinen Grenzen verbraucht hat.

Ein Lauf, den Du hier startest, bleibt auf diesem Gerät: nichts davon geht an ein Modell, deshalb liest er auch Notizen, die Du von der Cloud fernhältst. Probelauf ruft die Werkzeuge auf, die lesen, und schreibt einen Aufruf, der in der App etwas zeigen oder einen Vorschlag hinterlassen würde, nur auf.

In einem Gespräch

In einem gewöhnlichen Gespräch kann die KI Deine aktiven Skripte finden und eines ausführen, wenn es passt; der Schritt heißt dann Führt das Skript „word-count“ aus. Das Skript liest nur, was dieses Gespräch lesen darf: eine Notiz, die Du von der Cloud fernhältst, bleibt fern, und jede Notiz, die das Skript liest, zählt zu dem, was der Lauf gelesen hat. Was es zurückgibt, geht als Daten an das Modell, nie als Anweisung. Eine Routine, der Testlauf eines Skills und die Einstiege Bild erklären und Notiz daraus machen führen kein Skript aus, einem Gespräch, das mit einem Skill gestartet wurde, werden keine angeboten, und einer KI-App, die über den MCP-Server verbunden ist, auch nicht.

Änderungen vorschlagen

Ein Skript kann auch Werkzeuge bekommen, die vorschlagen. Die Werkzeuge Schlägt Änderungen an einer Notiz vor und Schlägt einen Eigenschaftswert vor hinterlassen einen Vorschlag am Rand einer Notiz; Entwirft eine Notiz, Entwirft einen Datenbank-Eintrag, Entwirft eine Aufgabe und Entwirft einen Journal-Eintrag hinterlassen einen Entwurf. Beides trägt den Namen des Skripts. Ein Skript, das Du hier mit Ausführen startest, schreibt nichts direkt: In Deinem Vault ändert sich nichts, bevor Du einen Vorschlag übernimmst oder einen Entwurf anlegst — genau wie bei einem Vorschlag der KI. Nach einem Lauf führt der Dialog sie unter Vorschläge und Entwürfe auf; ein Lauf, der mit Probelauf gestartet wurde, hinterlässt nichts.

Was ein Skript gelesen hat, entscheidet, wo es schreiben darf: einen Vorschlag oder einen Entwurf, der auf einer Notiz beruht, die Du von der Cloud fernhältst, nimmt nur ein Ort an, für den dieselbe Regel gilt. In einem Gespräch wird der KI ein Skript, das vorschlägt, nur angeboten, wo das Gespräch selbst vorschlagen kann, und was das Skript dort hinterlässt, trägt den Namen des Modells dieses Gesprächs. Wo das Gespräch Änderungen direkt übernimmt — mit dem Chip Direkt übernehmen oder für ein Ziel in einem Ordner, der Ohne Nachfrage ändern erlaubt —, geht auch das, was ein solches Skript schreibt, direkt hinein: eine Änderung an einer Notiz und an ihren Eigenschaften, eine neue Notiz, ein Datenbank-Eintrag, eine Aufgabe oder ein Journal-Eintrag, mit demselben Netz wie die eigenen direkten Änderungen des Assistenten (siehe „Direkt übernehmen“ in KI-Assistent). So kann ein Lauf viele Notizen ändern: Die KI darf in jedem Schritt ihrer Antwort ein Skript starten, und jeder Start darf so viele Aufrufe machen, wie die Grenze des Skripts zulässt. Jede Änderung behält ihre Fassung davor, und die Antwort führt sie alle mit Alle zurücknehmen auf. Ohne diese Erlaubnis hinterlässt das Skript Vorschläge und Entwürfe, wie oben.

Ein Skript schreiben

Neues Skript fragt nach:

Anlegen und freigeben schreibt das Skript als .agent/scripts/<name>/ in Deinen Vault — eine manifest.json und eine main.js — und gibt es auf diesem Gerät frei. Bearbeiten im Menü eines Skripts öffnet dasselbe Formular; Speichern und freigeben ersetzt die Dateien.

Der Code ist der Rumpf einer Funktion. input enthält die Eingaben unter ihrem Namen, tools.<name>(…) ruft ein Werkzeug auf und wird mit await abgewartet, return gibt das Ergebnis zurück, und console.log(…) schreibt eine Zeile ins Protokoll:

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 };

Die Sprache ist aktuelles JavaScript — ES2024, dazu das meiste von ES2025 — ohne Intl. Es gibt kein fetch, keinen Timer, kein import und keinen Zugriff auf Dateien, und was ein Skript zurückgibt, muss sich als JSON schreiben lassen. Ein Werkzeug, das ablehnt — eine Notiz, die es nicht gibt, eine Notiz, die das Gespräch nicht lesen darf —, wirft einen Fehler, den das Skript abfangen kann.

Was ein Werkzeug zurückgibt

Was ein Werkzeug zurückgibt im Formular öffnet diese Seite. Jedes Werkzeug nimmt ein Objekt und gibt eines zurück; cursor nimmt das next des Aufrufs davor und setzt dessen Liste fort.

WerkzeugDu übergibstDu bekommst
search_vault — Durchsucht den Vaultquery; wahlweise folder, limit (bis 25), cursorresults: eine Liste aus { title, path, snippet }; next
read_note — Liest eine Notizpath; wahlweise section, maxChars (200 bis 20.000), cursorpath, text, next
get_outline — Liest die Gliederungpathpath; properties: Name und Wert; sections: eine Liste aus { level, text, section }
query_base — Liest eine Datenbankbase, der Pfad der .base-Datei; wahlweise view, limit (bis 50), cursorbase, view, views; rows: eine Liste aus { title, path, properties }; next
get_tasks — Liest Aufgabenwahlweise range (today, upcoming, overdue, inbox, all, done), limit (bis 50), cursortasks: eine Liste aus { state, title, due, priority, path, note, source }; next
get_backlinks — Liest Backlinkspath; wahlweise limit (bis 50), cursorpath; notes: eine Liste aus { title, path, links, places }; next
graph_neighborhood — Folgt Linkspath; wahlweise depth (1 oder 2), limit (bis 50)path; notes: eine Liste aus { title, path, fromHere, toHere, via }
get_recent — Sieht zuletzt benutzte Notizen anwahlweise kind (opened oder edited), limit (bis 20)kind; notes: eine Liste aus { title, path, at }
get_changes — Sieht nach, was sich geändert hatsince als YYYY-MM-DD; wahlweise until, folder, limit (bis 20)since, until; notes: eine Liste aus { path, title, kind, made, last, added, removed, gained }
get_note_history — Verfolgt, wie sich eine Notiz entwickelt hatpath; wahlweise since und until als YYYY-MM-DD, höchstens 31 Tage auseinanderpath, since, until, made; days: eine Liste aus { day, added, removed, gained }
get_calendar — Liest Terminefrom und to als YYYY-MM-DD, höchstens 31 Tage auseinander; wahlweise details, limit (bis 100)events: eine Liste aus { day, start, end, allDay, title, cancelled, place, with, others, online, event }; more
run_command — Bedient die Appid, ein Befehl der App wie open-note, show-in-graph oder open-calendar; wahlweise args mit path, section oder datedone, command
propose_edit — Schlägt Änderungen an einer Notiz vorpath; edits, eine Liste aus { find, replace }, oder append; wahlweise section, noteproposed, path, passages
set_property — Schlägt einen Eigenschaftswert vorpath, key, value; wahlweise noteproposed, path, property
create_note — Entwirft eine Notiztitle, content; wahlweise folderdrafted, kind, title
create_entry — Entwirft einen Datenbank-Eintragbase, title; wahlweise properties, contentdrafted, kind, title, base
create_task — Entwirft eine Aufgabetextdrafted, kind, title
add_journal_entry — Entwirft einen Journal-Eintragtext; wahlweise taskdrafted, kind

Grenzen

Ein Skript trägt seine Grenzen in seinem Manifest. Drei davon setzt das Formular:

GrenzeVorgabeBereich
Sekunden Rechenzeit51 bis 30
Aufrufe von Werkzeugen200 bis 50
Speicher in MB328 bis 128

Es zählt nur die Zeit, in der ein Skript rechnet, nicht die Zeit, die ein Werkzeug braucht. Ein Skript, das eine Grenze überschreitet — Zeit, Speicher, Schritte, die Zahl der Aufrufe, die Größe der Argumente eines Aufrufs oder die Größe des Ergebnisses, das das Skript selbst zurückgibt —, wird beendet, der Dialog sagt, welche Grenze es war, und ein beendetes Skript gibt nichts zurück. Eine Antwort eines Werkzeugs, die größer ist als die Grenze für einen Aufruf, ist kein Ende: Das Skript bekommt für diesen Aufruf einen Fehler und läuft weiter. Standardmäßig dürfen die Argumente eines Aufrufs, was ein Aufruf zurückgibt, und das Ergebnis je höchstens 64 KB groß sein; ein Manifest darf bis zu 256 KB erlauben.

Nichts läuft, bevor Du es freigibst

Ein Skript, das neu oder geändert ist — durch den Sync, oder von einem anderen Programm geschrieben —, läuft nicht, bis Du es auf diesem Gerät freigibst. Es wartet oben unter Skills bei Warten auf Deine Freigabe. Prüfen und freigeben zeigt Was es darf, seine Grenzen, seine Eingabe und den ganzen Code, und sagt, ob sich der Code als JavaScript lesen lässt; Code, bei dem das nicht geht, wird nicht freigegeben.

Mit Freigeben unterschreibt dieses Gerät genau diese Dateien. Der Schlüssel dafür entsteht auf diesem Gerät und liegt in seinem Schlüsselbund. Jede Änderung an einer Datei hebt die Freigabe auf, und auf jedem Deiner anderen Geräte wartet das Skript auf eine eigene Freigabe — eine Freigabe lässt sich nicht von einem Gerät auf ein anderes mitnehmen. Freigabe zurückziehen im Menü eines Skripts nimmt sie zurück, und Code ansehen zeigt die Prüfung noch einmal.

Grenzen der Beta

Ein Skript schlägt vor und entwirft und schreibt nur in einem Gespräch direkt, in dem Du den Assistenten Änderungen direkt übernehmen lässt; es benennt, verschiebt oder löscht nie eine Notiz, und es schreibt keine E-Mail und keinen Termin. Ein Skill kann kein Skript starten, und der eigene Ordner scripts/ eines Skills wird nicht ausgeführt. E-Mails, das Internet und die Werkzeuge externer Server stehen Skripten nicht zur Verfügung.