Scripts (Bêta)
Dernière mise à jour : 2026-11-17
Un script est un petit programme pour ce qu’un modèle fait mal et qu’un programme exécute chaque fois de la même façon : compter, trier, comparer, additionner. Vous l’écrivez en JavaScript. Il s’exécute dans une boîte fermée à l’intérieur de Plainva : il ne peut ni ouvrir un fichier, ni accéder au réseau, ni remettre quoi que ce soit à plus tard. Il n’appelle que les outils que vous avez cochés pour lui : ils lisent votre vault comme le font les outils de l’IA, ou laissent une proposition dont vous décidez. Un script que vous lancez ici ne modifie rien de lui-même ; un script que l’IA lance dans une conversation peut écrire directement là où vous l’autorisez (voir « Dans une conversation » plus bas).
Exécuter un script
Vos scripts se trouvent sous Compétences dans l’onglet IA — sur le téléphone sur l’écran IA dans les compétences — dans le groupe Scripts. Avec Exécuter, vous ouvrez le script : renseignez ce qu’il demande, puis appuyez sur Exécuter. Pendant l’exécution, vous voyez chaque outil qu’il appelle, et le bouton Arrêter y met fin. Ensuite, la boîte de dialogue affiche les Appels, le Résultat — que vous pouvez copier — et le Journal, ainsi que ce que l’exécution a consommé de ses limites.
Une exécution que vous lancez ici reste sur cet appareil : rien n’en part vers un modèle, elle lit donc aussi les notes que vous tenez à l’écart du cloud. Avec Essai à blanc, le script appelle les outils qui lisent et se contente de noter un appel qui afficherait quelque chose dans l’app ou laisserait une proposition.
Dans une conversation
Dans une conversation ordinaire, l’IA peut trouver vos scripts actifs et en exécuter un quand cela convient ; l’étape s’affiche alors ainsi : Exécution du script « word-count ». Le script ne lit que ce que cette conversation a le droit de lire : une note que vous tenez à l’écart du cloud le reste, et chaque note que le script lit compte parmi ce que l’exécution a lu. Ce qu’il renvoie va au modèle comme des données, jamais comme des instructions. Une routine, l’exécution de test d’une compétence et les points d’entrée Expliquer l’image et En faire une note n’exécutent aucun script, aucun n’est proposé à une conversation lancée avec une compétence, ni à une app d’IA connectée par le serveur MCP.
Proposer des modifications
Un script peut aussi recevoir des outils qui font des propositions. Les outils Proposition de modifications d’une note et Proposition d’une valeur de propriété laissent une proposition dans la marge d’une note ; les outils Brouillon d’une note, Brouillon d’une entrée de base de données, Brouillon d’une tâche et Brouillon d’une entrée de journal laissent un brouillon. Les deux portent le nom du script. Un script que vous lancez ici avec Exécuter n’écrit rien directement : rien ne change dans votre vault avant que vous n’acceptiez une proposition ou ne créiez un brouillon — exactement comme pour une proposition de l’IA. Après une exécution, la boîte de dialogue les répertorie sous Propositions et brouillons ; une exécution lancée avec Essai à blanc ne laisse rien.
Ce qu’un script a lu détermine où il peut écrire : une proposition ou un brouillon qui repose sur une note que vous tenez à l’écart du cloud ne peut être déposé que dans un emplacement soumis à la même règle. Dans une conversation, un script qui fait des propositions n’est mis à la disposition de l’IA que là où la conversation peut elle-même en faire, et ce que le script y laisse porte le nom du modèle de la conversation. Là où la conversation applique directement les modifications — avec la puce Appliquer directement, ou pour une cible dans un dossier qui autorise Modifier sans demander —, ce qu’écrit un tel script entre lui aussi directement : une modification d’une note et de ses propriétés, une nouvelle note, une entrée de base de données, une tâche ou une entrée de journal, avec le même filet que les modifications directes de l’assistant (voir « Appliquer directement » dans Assistant IA). Une exécution peut ainsi modifier de nombreuses notes : l’IA peut lancer un script à chaque étape de sa réponse, et chaque lancement peut faire autant d’appels que la limite du script le permet. Chaque modification garde sa version d’avant, et la réponse les liste toutes avec Tout annuler. Sans cette autorisation, le script laisse des propositions et des brouillons, comme plus haut.
Écrire un script
Nouveau script demande :
- Nom — des minuscules, des chiffres et des tirets ; il devient le nom du dossier.
- Description — à quoi sert le script ; c’est à cela que vous le reconnaissez, et l’IA aussi.
- Outils — cochez ce que le script peut appeler : sous Lire ce qui lit, sous Proposer ce qui laisse une proposition ou un brouillon. Rien d’autre n’existe pour lui.
- Entrées — ce que le script demande au démarrage : un nom, s’il s’agit d’un texte, d’un nombre ou d’un choix oui ou non, et si c’est obligatoire.
- Limites — secondes de calcul, appels d’outils et mémoire.
- Code — le programme.
Créer et approuver écrit le script dans .agent/scripts/<name>/ de votre vault — un manifest.json et un main.js — et l’approuve sur cet appareil. Modifier, dans le menu d’un script, ouvre le même formulaire ; Enregistrer et approuver remplace les fichiers.
Le code est le corps d’une fonction. input contient les entrées, chacune sous son nom, tools.<name>(…) appelle un outil dont il faut attendre la réponse, return renvoie le résultat, et console.log(…) écrit une ligne dans le journal :
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 };
Le langage est un JavaScript actuel — ES2024 et l’essentiel d’ES2025 —, sans Intl. Il n’y a ni fetch, ni minuteur, ni import, ni accès aux fichiers, et ce qu’un script renvoie doit être des données qui peuvent s’écrire en JSON. Un outil qui refuse — une note qui n’existe pas, une note que la conversation n’a pas le droit de lire — lève une erreur que le script peut intercepter.
Ce que renvoie un outil
Dans le formulaire, Ce que renvoie un outil ouvre cette page. Chaque outil reçoit un objet et en renvoie un ; cursor reprend le next de l’appel précédent et poursuit sa liste.
| Outil | Vous transmettez | Vous obtenez |
|---|---|---|
search_vault — Recherche dans le vault | query ; facultatifs : folder, limit (jusqu’à 25), cursor | results : une liste de { title, path, snippet } ; next |
read_note — Lecture d’une note | path ; facultatifs : section, maxChars (de 200 à 20 000), cursor | path, text, next |
get_outline — Lecture du plan | path | path ; properties : nom et valeur ; sections : une liste de { level, text, section } |
query_base — Lecture d’une base de données | base, le chemin du fichier .base ; facultatifs : view, limit (jusqu’à 50), cursor | base, view, views ; rows : une liste de { title, path, properties } ; next |
get_tasks — Lecture des tâches | facultatifs : range (today, upcoming, overdue, inbox, all, done), limit (jusqu’à 50), cursor | tasks : une liste de { state, title, due, priority, path, note, source } ; next |
get_backlinks — Lecture des backlinks | path ; facultatifs : limit (jusqu’à 50), cursor | path ; notes : une liste de { title, path, links, places } ; next |
graph_neighborhood — Suivi des liens | path ; facultatifs : depth (1 ou 2), limit (jusqu’à 50) | path ; notes : une liste de { title, path, fromHere, toHere, via } |
get_recent — Consultation des notes récentes | facultatifs : kind (opened ou edited), limit (jusqu’à 20) | kind ; notes : une liste de { title, path, at } |
get_changes — Consultation de ce qui a changé | since au format YYYY-MM-DD ; facultatifs : until, folder, limit (jusqu’à 20) | since, until ; notes : une liste de { path, title, kind, made, last, added, removed, gained } |
get_note_history — Suivi de l’évolution d’une note | path ; facultatifs : since et until au format YYYY-MM-DD, à 31 jours d’écart au plus | path, since, until, made ; days : une liste de { day, added, removed, gained } |
get_calendar — Lecture des rendez-vous | from et to au format YYYY-MM-DD, à 31 jours d’écart au plus ; facultatifs : details, limit (jusqu’à 100) | events : une liste de { day, start, end, allDay, title, cancelled, place, with, others, online, event } ; more |
run_command — Utilisation de l’application | id, une commande de l’app comme open-note, show-in-graph ou open-calendar ; facultatif : args avec path, section ou date | done, command |
propose_edit — Proposition de modifications d’une note | path ; edits, une liste de { find, replace }, ou append ; facultatifs : section, note | proposed, path, passages |
set_property — Proposition d’une valeur de propriété | path, key, value ; facultatif : note | proposed, path, property |
create_note — Brouillon d’une note | title, content ; facultatif : folder | drafted, kind, title |
create_entry — Brouillon d’une entrée de base de données | base, title ; facultatifs : properties, content | drafted, kind, title, base |
create_task — Brouillon d’une tâche | text | drafted, kind, title |
add_journal_entry — Brouillon d’une entrée de journal | text ; facultatif : task | drafted, kind |
Limites
Un script porte ses limites dans son manifeste. Le formulaire en fixe trois :
| Limite | Par défaut | Plage autorisée |
|---|---|---|
| Secondes de calcul | 5 | 1 à 30 |
| Appels d’outils | 20 | 0 à 50 |
| Mémoire en Mo | 32 | 8 à 128 |
Seul compte le temps pendant lequel un script calcule, pas celui qu’un outil met à répondre. Un script qui dépasse une limite — temps, mémoire, étapes, nombre d’appels, taille des arguments d’un appel ou taille du résultat que le script renvoie lui-même — est arrêté, la boîte de dialogue dit laquelle, et un script arrêté ne renvoie rien. La réponse d’un outil plus grande que la limite d’un appel n’est pas une fin : le script reçoit une erreur pour cet appel et continue. Par défaut, les arguments d’un appel, ce qu’un appel renvoie et le résultat ne peuvent chacun dépasser 64 Ko ; un manifeste peut autoriser jusqu’à 256 Ko.
Rien ne s’exécute avant votre approbation
Un script nouveau ou modifié — par la synchronisation, ou écrit par un autre programme — ne s’exécute pas tant que vous ne l’avez pas approuvé sur cet appareil. Il attend en haut de Compétences, sous En attente de votre approbation. Vérifier et approuver montre Ce qu’il peut faire, ses Limites, son Entrée et tout le Code, et indique si le code peut être lu comme du JavaScript ; un code qui ne peut pas l’être n’est pas approuvé.
Avec Approuver, cet appareil signe exactement ces fichiers. La clé nécessaire est créée sur cet appareil et conservée dans son trousseau. Toute modification d’un fichier annule l’approbation, et sur chacun de vos autres appareils le script attend sa propre approbation — une approbation ne peut pas passer d’un appareil à un autre. Retirer l’approbation, dans le menu d’un script, la révoque, et Voir le code affiche de nouveau la vérification.
Limites de la bêta
Un script propose et laisse des brouillons, et n’écrit directement que dans une conversation où vous laissez l’assistant appliquer directement les modifications ; il ne renomme, ne déplace ni ne supprime jamais une note, et il ne rédige ni e-mail ni rendez-vous. Une compétence ne peut pas lancer de script, et le dossier scripts/ propre à une compétence n’est pas exécuté. Les e-mails, Internet et les outils des serveurs externes ne sont pas disponibles pour les scripts.