sre-helmcode · Oct 10, 2026 · Oct 10, 2026 · Oct 10, 2026 · Oct 10, 2026 · Oct 10, 2026
diff --git a/public/docs/runs/runs-01-tab.webp b/public/docs/runs/runs-01-tab.webp
diff --git a/public/docs/runs/runs-02-new-run.webp b/public/docs/runs/runs-02-new-run.webp
diff --git a/public/docs/runs/runs-03-run-page.webp b/public/docs/runs/runs-03-run-page.webp
diff --git a/src/content/docs-es/apps.md b/src/content/docs-es/apps.md
@@ -1,7 +1,7 @@
 ---
 title: Apps
 description: Despliega tus apps desde GitHub a NaN Cloud en minutos.
-order: 20
+order: 21
 group: Guías
 ---
 

diff --git a/src/content/docs-es/examples.md b/src/content/docs-es/examples.md
@@ -1,7 +1,7 @@
 ---
 title: Ejemplos
 description: Fragmentos de código para conectarte a la API de NaN con Python, Node.js, curl y más.
-order: 19
+order: 20
 group: Guías
 ---
 

diff --git a/src/content/docs-es/intro.md b/src/content/docs-es/intro.md
@@ -31,5 +31,6 @@ Los límites van por API key — un tope de peticiones por minuto y un máximo d
 - [Referencia de la API](/es/docs/api): todos los endpoints, campo a campo.
 - [Modelos](/es/docs/models): las fichas técnicas y los límites.
 - [Workspaces](/es/docs/workspaces): tu propia máquina en la nube, por SSH y en el navegador, con agentes de código listos para usar.
+- [Runs de agentes](/es/docs/runs): dale una tarea a un agente dentro de tu workspace y deja que trabaje solo.
 - [Ejemplos](/es/docs/examples): fragmentos en Python, Node.js y curl.
 - Soporte: reporta incidencias en `#support` de Discord.
diff --git a/src/content/docs-es/nan-cli.mdx b/src/content/docs-es/nan-cli.mdx
@@ -156,6 +156,18 @@ En Linux con bash, el mismo comando pero contra `~/.bashrc`.
 
 </Details>
 
+## Runs
+
+Desde la v0.1.25 la CLI también pone a trabajar agentes en tareas dentro de tus [workspaces](/es/docs/workspaces), y los sigue desde tu terminal:
+
+```bash
+nan run "añade tests al parser de fechas y haz que pasen"
+nan runs ls
+nan runs logs <id> -f
+```
+
+El run se ejecuta en el workspace, no en tu máquina, así que sigue aunque cierres la terminal. Los comandos de runs usan tu sesión de `nan auth login`, o un token de plataforma desde `NAN_TOKEN`, `--token-file` o `nan auth login --api-token` para scripts, CI y servidores. Todos los flags, el orden de autenticación, los códigos de salida y la API están en [Runs de agentes](/es/docs/runs).
+
 ## Actualizar
 
 Vuelve a pasar el instalador. Siempre trae la última versión publicada y sobrescribe la que tengas:

diff --git a/src/content/docs-es/runs.mdx b/src/content/docs-es/runs.mdx
diff --git a/src/content/docs-es/workspaces.mdx b/src/content/docs-es/workspaces.mdx
@@ -215,6 +215,12 @@ gentle-shell es un complemento de Pi (memoria entre sesiones con Engram), así q
 
 Con un plan de inferencia, los agentes vienen configurados para usar los modelos de NaN con tu membresía. Las guías de [Pi](/es/docs/pi) y [Hermes](/es/docs/hermes) explican cómo cambiar el modelo o el proveedor a mano.
 
+## Pon a tus agentes a trabajar en tareas
+
+No hace falta que te quedes conectado mientras un agente trabaja. Un **run** le da una tarea a Pi o a Hermes dentro de tu workspace y lo deja trabajar solo: sigues su log en directo, continúa aunque cierres la página y, en un repositorio git, sus cambios acaban en una rama para que los revises. Lánzalo desde la pestaña **Runs** del workspace, desde tu terminal con `nan run` o desde la API.
+
+Cómo funciona, los límites y los comandos están en [Runs de agentes](/es/docs/runs).
+
 ## Copias de seguridad
 
 Los workspaces **no tienen copias de seguridad** salvo que actives el **complemento de backups** de ese workspace, desde su pestaña **Backups**.

diff --git a/src/content/docs/apps.md b/src/content/docs/apps.md
@@ -1,7 +1,7 @@
 ---
 title: Apps
 description: Deploy your apps from GitHub to NaN Cloud in minutes.
-order: 20
+order: 21
 group: Guides
 ---
 

diff --git a/src/content/docs/examples.md b/src/content/docs/examples.md
@@ -1,7 +1,7 @@
 ---
 title: Examples
 description: Code snippets to connect to the NaN API with Python, Node.js, curl, and more.
-order: 19
+order: 20
 group: Guides
 ---
 

diff --git a/src/content/docs/intro.md b/src/content/docs/intro.md
@@ -31,5 +31,6 @@ Limits are per API key — a cap on requests per minute and a maximum number of
 - [API reference](/docs/api): every endpoint, field by field.
 - [Models](/docs/models): the spec sheets and the limits.
 - [Workspaces](/docs/workspaces): your own cloud machine, over SSH and in the browser, with coding agents ready to use.
+- [Agent runs](/docs/runs): give an agent a task inside your workspace and let it work on its own.
 - [Examples](/docs/examples): snippets in Python, Node.js and curl.
 - Support: report issues in `#support` on Discord.
diff --git a/src/content/docs/nan-cli.mdx b/src/content/docs/nan-cli.mdx
@@ -156,6 +156,18 @@ On Linux with bash, the same command but against `~/.bashrc`.
 
 </Details>
 
+## Runs
+
+From v0.1.25 the CLI also starts agents on tasks inside your [workspaces](/docs/workspaces), and follows them from your terminal:
+
+```bash
+nan run "add tests for the date parser and make them pass"
+nan runs ls
+nan runs logs <id> -f
+```
+
+The run happens in the workspace, not on your machine, so it keeps going if you close the terminal. The runs commands use your `nan auth login` session, or a platform token from `NAN_TOKEN`, `--token-file` or `nan auth login --api-token` for scripts, CI and servers. Every flag, the authentication order, the exit codes and the API are in [Agent runs](/docs/runs).
+
 ## Updating
 
 Run the installer again. It always brings the latest published release and overwrites the one you have: