Scripts (Beta)

Última actualización: 2026-11-17

Un script es un programa pequeño para lo que un modelo hace mal y un programa hace siempre igual: contar, ordenar, comparar, sumar. Lo escribes en JavaScript. Se ejecuta en un entorno aislado dentro de Plainva: no puede abrir un archivo, llegar a la red ni esperar hasta más tarde. Solo llama a las herramientas que marcaste para él: estas leen tu vault igual que las herramientas de la IA o dejan una sugerencia sobre la que decides tú. Un script que inicias aquí no cambia nada por sí solo; uno que la IA inicia en una conversación puede escribir directamente donde lo permites (consulta «En una conversación» más abajo).

Ejecutar un script

Tus scripts están en Habilidades, en la pestaña de IA —en el teléfono, en la pantalla de IA, en las habilidades—, dentro del grupo Scripts. Ejecutar abre el script: rellena lo que pide y pulsa Ejecutar. Mientras se ejecuta ves cada herramienta a la que llama, y con Detener lo terminas. Después, el diálogo muestra las Llamadas, el Resultado —que puedes copiar— y el Registro, y también cuánto de sus límites usó la ejecución.

Una ejecución que inicias aquí se queda en este dispositivo: nada de ello va a un modelo, así que también lee las notas que mantienes fuera de la nube. Ejecución de prueba llama a las herramientas que leen y solo anota las llamadas que mostrarían algo en la app o dejarían una sugerencia.

En una conversación

En una conversación normal, la IA puede encontrar tus scripts activos y ejecutar uno cuando encaja; el paso dice entonces Ejecutando el script «word-count». El script lee solo lo que esa conversación puede leer: una nota que mantienes fuera de la nube sigue sin salir de este dispositivo, y cada nota que lee el script cuenta entre lo que leyó la ejecución. Lo que devuelve va al modelo como datos, nunca como instrucciones. Una rutina, la ejecución de prueba de una habilidad y los puntos de entrada Explicar imagen y Convertir en nota no ejecutan ningún script, a una conversación iniciada con una habilidad no se le ofrece ninguno, y tampoco a una app de IA conectada mediante el servidor MCP.

Sugerir cambios

A un script también se le pueden dar herramientas que sugieren. Las herramientas Sugiriendo cambios en una nota y Sugiriendo un valor de propiedad dejan una sugerencia en el margen de una nota; las herramientas Redactando el borrador de una nota, Redactando el borrador de una entrada de base de datos, Redactando el borrador de una tarea y Redactando el borrador de una entrada de diario dejan un borrador. Ambos van firmados con el nombre del script. Un script que inicias aquí con Ejecutar no escribe nada directamente: nada cambia en tu vault antes de que aceptes una sugerencia o crees un borrador, exactamente como con una sugerencia de la IA. Después de una ejecución, el diálogo los enumera bajo Sugerencias y borradores; una ejecución iniciada con Ejecución de prueba no deja nada.

Lo que un script ha leído decide dónde puede escribir: una sugerencia o un borrador que se apoya en una nota que mantienes fuera de la nube solo puede quedar en un lugar sujeto a la misma regla. En una conversación, a la IA se le ofrece un script que sugiere solo donde la propia conversación puede sugerir, y lo que el script deja allí lleva el nombre del modelo de la conversación. Donde la conversación aplica los cambios directamente —con el chip Aplicar directamente o para un destino en una carpeta que permite Cambiar sin preguntar—, lo que escribe un script así también entra directamente: un cambio en una nota y en sus propiedades, una nota nueva, una entrada de base de datos, una tarea o una entrada de diario, con la misma red que los cambios directos del propio asistente (consulta «Aplicar directamente» en Asistente de IA). Así, una ejecución puede cambiar muchas notas: la IA puede iniciar un script en cada paso de su respuesta, y cada inicio puede hacer tantas llamadas como permita el límite del script. Cada cambio conserva su versión anterior, y la respuesta los enumera todos con Deshacer todo. Sin ese permiso, el script deja sugerencias y borradores, como arriba.

Escribir un script

Nuevo script pide:

Crear y aprobar escribe el script en tu vault como .agent/scripts/<name>/ —un manifest.json y un main.js— y lo aprueba en este dispositivo. Editar en el menú de un script abre el mismo formulario; Guardar y aprobar sustituye los archivos.

El código es el cuerpo de una función. input contiene las entradas por su nombre, tools.<name>(…) llama a una herramienta y se espera con await, return devuelve el resultado y console.log(…) escribe una línea en el registro:

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

El lenguaje es JavaScript actual —ES2024 y la mayor parte de ES2025—, sin Intl. No hay fetch, temporizador, import ni acceso a archivos, y lo que devuelve un script tiene que ser algo que pueda escribirse como JSON. Una herramienta que rechaza la llamada —por ejemplo, una nota que no existe o una nota que la conversación no puede leer— lanza un error que el script puede capturar.

Qué devuelve una herramienta

Qué devuelve una herramienta en el formulario abre esta página. Cada herramienta recibe un objeto y devuelve uno; cursor toma el next de la llamada anterior y continúa su lista.

HerramientaLo que pasasLo que obtienes
search_vault — Buscando en el vaultquery; opcionalmente folder, limit (hasta 25), cursorresults: una lista de { title, path, snippet }; next
read_note — Leyendo una notapath; opcionalmente section, maxChars (de 200 a 20.000), cursorpath, text, next
get_outline — Leyendo el esquemapathpath; properties: nombre y valor; sections: una lista de { level, text, section }
query_base — Leyendo una base de datosbase, la ruta del archivo .base; opcionalmente view, limit (hasta 50), cursorbase, view, views; rows: una lista de { title, path, properties }; next
get_tasks — Leyendo tareasopcionalmente range (today, upcoming, overdue, inbox, all, done), limit (hasta 50), cursortasks: una lista de { state, title, due, priority, path, note, source }; next
get_backlinks — Leyendo retroenlacespath; opcionalmente limit (hasta 50), cursorpath; notes: una lista de { title, path, links, places }; next
graph_neighborhood — Siguiendo enlacespath; opcionalmente depth (1 o 2), limit (hasta 50)path; notes: una lista de { title, path, fromHere, toHere, via }
get_recent — Mirando notas recientesopcionalmente kind (opened o edited), limit (hasta 20)kind; notes: una lista de { title, path, at }
get_changes — Mirando qué cambiósince como YYYY-MM-DD; opcionalmente until, folder, limit (hasta 20)since, until; notes: una lista de { path, title, kind, made, last, added, removed, gained }
get_note_history — Siguiendo la evolución de una notapath; opcionalmente since y until como YYYY-MM-DD, con 31 días de diferencia como máximopath, since, until, made; days: una lista de { day, added, removed, gained }
get_calendar — Leyendo citasfrom y to como YYYY-MM-DD, con 31 días de diferencia como máximo; opcionalmente details, limit (hasta 100)events: una lista de { day, start, end, allDay, title, cancelled, place, with, others, online, event }; more
run_command — Usando la aplicaciónid, un comando de la app como open-note, show-in-graph u open-calendar; opcionalmente args con path, section o datedone, command
propose_edit — Sugiriendo cambios en una notapath; edits, una lista de { find, replace }, o append; opcionalmente section, noteproposed, path, passages
set_property — Sugiriendo un valor de propiedadpath, key, value; opcionalmente noteproposed, path, property
create_note — Redactando el borrador de una notatitle, content; opcionalmente folderdrafted, kind, title
create_entry — Redactando el borrador de una entrada de base de datosbase, title; opcionalmente properties, contentdrafted, kind, title, base
create_task — Redactando el borrador de una tareatextdrafted, kind, title
add_journal_entry — Redactando el borrador de una entrada de diariotext; opcionalmente taskdrafted, kind

Límites

Un script lleva sus límites en su manifiesto. El formulario fija tres de ellos:

LímitePor defectoRango
Segundos de cálculo5de 1 a 30
Llamadas a herramientas20de 0 a 50
Memoria en MB32de 8 a 128

Solo cuenta el tiempo que un script pasa calculando, no el que tarda una herramienta. Un script que supera un límite —tiempo, memoria, pasos, el número de llamadas, el tamaño de los argumentos de una llamada o el tamaño del resultado del propio script— se termina, el diálogo dice cuál fue el límite y un script terminado no devuelve nada. La respuesta de una herramienta que supera el límite de una llamada no es un final: el script recibe un error por esa llamada y sigue ejecutándose. Por defecto, los argumentos de una llamada, lo que devuelve una llamada y el resultado pueden ocupar, cada uno, 64 KB como máximo; un manifiesto puede permitir hasta 256 KB.

Nada se ejecuta antes de que lo apruebes

Un script nuevo o cambiado —por sincronización o escrito por otro programa— no se ejecuta hasta que lo apruebes en este dispositivo. Espera arriba en Habilidades, en Esperan tu aprobación. Revisar y aprobar muestra Qué puede hacer, sus Límites, su Entrada y todo el Código, e indica si el código se puede leer como JavaScript; un código que no se puede leer no se aprueba.

Con Aprobar, este dispositivo firma exactamente estos archivos. La clave para ello se crea en este dispositivo y se guarda en su llavero. Cualquier cambio en un archivo anula la aprobación, y en cada uno de tus otros dispositivos el script espera su propia aprobación: una aprobación no se puede llevar de un dispositivo a otro. Retirar la aprobación en el menú de un script la quita, y Ver el código muestra la revisión otra vez.

Límites de la beta

Un script sugiere y deja borradores, y solo escribe directamente en una conversación en la que dejas que el asistente aplique los cambios directamente; nunca renombra, mueve ni elimina una nota, y no redacta ningún correo ni ninguna cita. Una habilidad no puede iniciar un script, y la carpeta scripts/ propia de una habilidad no se ejecuta. El correo, Internet y las herramientas de servidores externos no están disponibles para los scripts.