sre-helmcode · Oct 12, 2026 · Oct 12, 2026 · Oct 12, 2026
diff --git a/src/content/docs-es/automations.mdx b/src/content/docs-es/automations.mdx
@@ -23,7 +23,7 @@ El agente de una automatización no hace push ni publica nada por su cuenta. **P
 
 ## Antes de empezar
 
-- **Un workspace encendido**, con Pi o Hermes instalado, como para cualquier [run](/es/docs/runs#antes-de-empezar).
+- **Un workspace encendido**, con el agente que quieras instalado (Pi, Pi + Gentle Shell o Hermes), como para cualquier [run](/es/docs/runs#elige-el-agente).
 - **Un plan con inferencia.** Los runs de una automatización usan la clave de inferencia de tu workspace y cuentan para el uso de tu plan como cualquier otro run.
 - **Una sesión en el navegador.** Crear o cambiar automatizaciones, escribir secretos y aprobar acciones exige que hayas iniciado sesión en [cloud.nan.builders](https://cloud.nan.builders/) desde tu navegador, con el enlace por correo. Una sesión de la CLI, una API key o un token pueden listar automatizaciones y lanzarlas, pero nunca cambiarlas. Consulta [Por qué algunas acciones necesitan el navegador](#por-qué-algunas-acciones-necesitan-el-navegador).
 - **Para las plantillas de GitHub, un token de GitHub guardado como secreto.** Sin él la automatización no se puede guardar, así que créalo antes: consulta [Un token de GitHub para las acciones](#un-token-de-github-para-las-acciones).
@@ -58,7 +58,7 @@ Las tres plantillas de GitHub actúan sobre un repositorio, así que necesitan u
 | **Description (optional)** | Una descripción, para ti. |
 | **Instructions** | Lo que tiene que hacer el agente, hasta 16 KiB. Tus instrucciones son de confianza. Lo que envíe un webhook o un run manual le llega al agente como datos, nunca como instrucciones. |
 | **Workspace** | El workspace donde trabaja el agente. |
-| **Agent** | Pi o Hermes. |
+| **Agent** | **Pi**, **Pi + Gentle Shell** o **Hermes**. Solo los agentes instalados en el **Workspace** elegido, así que elige antes el workspace. Un agente que quites luego del workspace aparece como **(not installed)** y sus runs se rechazan con `agent_not_installed`. Consulta [Elige el agente](/es/docs/runs#elige-el-agente). |
 | **Folder** | Dónde trabaja el agente, dentro de `/home/nan`. No se usa con **Fresh clone per run**. |
 | **Separate branch** | Rama aparte: **On** (por defecto), **Auto** u **Off (work in the folder directly)** (trabajar directamente en la carpeta), como en un [run](/es/docs/runs#dónde-trabaja-el-agente). No se usa con **Fresh clone per run**. |
 | **Time limit (minutes)** | El tiempo máximo, de 1 a 120. 30 por defecto. |

diff --git a/src/content/docs-es/pr-gatekeeper.mdx b/src/content/docs-es/pr-gatekeeper.mdx
@@ -90,7 +90,7 @@ Y cómo se comporta:
 ## Antes de empezar
 
 - **Un workspace encendido con las herramientas de tu repositorio.** El agente ejecuta los tests en uno de tus [workspaces](/es/docs/workspaces), así que necesita lo mismo que tu CI: Go, Node, Python... Instálalas una vez en el workspace, como lo harías en tu portátil, y mantenlo encendido: un workspace parado no puede lanzar runs, y los eventos que llegan mientras tanto se pierden. El ejemplo usa un workspace llamado `work` con Go instalado.
-- **Pi o Hermes instalado en ese workspace**, desde su [panel de Software](/es/docs/workspaces#agentes-y-el-panel-de-software). El ejemplo usa Pi.
+- **El agente instalado en ese workspace**: Pi, Pi + Gentle Shell o Hermes, desde su [panel de Software](/es/docs/workspaces#agentes-y-el-panel-de-software). La automatización solo puede usar un agente que el workspace tenga (consulta [Elige el agente](/es/docs/runs#elige-el-agente)). El ejemplo usa Pi.
 - **Un plan con inferencia.** Cada review es un [run de agente](/es/docs/runs) y usa tu plan como cualquier otra petición.
 - **Acceso de administrador al repositorio en GitHub**, para añadir el webhook y crear los tokens.
 - **Una sesión en el navegador en [cloud.nan.builders](https://cloud.nan.builders/)**, con el enlace del correo: la necesitas para crear automatizaciones y guardar secretos.

diff --git a/src/content/docs-es/runs.mdx b/src/content/docs-es/runs.mdx
@@ -12,7 +12,7 @@ import Screenshot from '../../components/docs/Screenshot.astro';
 
 # Runs de agentes.
 
-Un **run** le da una tarea a un agente dentro de uno de tus [workspaces](/es/docs/workspaces) y lo deja trabajar solo. Escribes lo que quieres que haga, eliges el agente (Pi o Hermes, el que tengas instalado en ese workspace) y la carpeta, y el run se encarga del resto. Sigue adelante aunque cierres la página o la terminal.
+Un **run** le da una tarea a un agente dentro de uno de tus [workspaces](/es/docs/workspaces) y lo deja trabajar solo. Escribes lo que quieres que haga, eliges el agente (Pi, Pi + Gentle Shell o Hermes, entre los que tengas instalados en ese workspace) y la carpeta, y el run se encarga del resto. Sigue adelante aunque cierres la página o la terminal.
 
 Mientras trabaja, sigues su log en directo. Cuando termina tienes su resultado y, si la carpeta es un repositorio git, una rama con sus cambios lista para que la revises.
 
@@ -26,9 +26,27 @@ Para lanzar la misma tarea una y otra vez, desde un webhook, con una programaci
 
 ## Antes de empezar
 
-- **Un workspace encendido**, con Pi o Hermes instalado. Puedes instalar cualquiera de los dos desde el panel de **Software** del workspace.
+- **Un workspace encendido**, con al menos un agente instalado: Pi, Pi + Gentle Shell o Hermes. Se instalan desde el [panel de Software](/es/docs/workspaces#agentes-y-el-panel-de-software) del workspace. Consulta [Elige el agente](#elige-el-agente).
 - **Un plan con inferencia.** Un run usa la clave de inferencia del propio workspace, y lo que gasta el agente cuenta para el uso de tu plan como cualquier otra petición. Si tu plan no incluye inferencia no puedes crear runs: el portal te enseña las opciones para mejorarlo.
 
+## Elige el agente
+
+Un run puede usar uno de tres agentes. Cada uno necesita sus programas instalados en el workspace:
+
+| Agente | Valor de `--agent` y `agent` | Qué necesita el workspace |
+|---|---|---|
+| **Pi** | `pi` | Pi. |
+| **Pi + Gentle Shell** | `pi_gentle` | Pi y gentle-shell. El run arranca Pi a través de gentle-shell, así que el agente trabaja con los subagentes, los guardarraíles y la memoria de gentle-shell. |
+| **Hermes** | `hermes` | Hermes, elegido al crear el workspace o instalado desde el panel de **Software**. |
+
+Los runs y las automatizaciones solo aceptan un agente que el workspace tenga instalado:
+
+- **En el portal**, la lista **Agent** de un run nuevo o de una automatización solo muestra los agentes de ese workspace. Si no tiene ninguno, el portal te lo indica y enlaza a su panel de **Software**: instala uno ahí primero.
+- **Desde la CLI o la API**, pedir un agente que el workspace no tiene se rechaza antes de crear el run, con `409 agent_not_installed` (el error señala el campo `agent`). `nan run` sale con código 4. Instala el agente desde el panel de **Software**, o elige otro, y vuelve a intentarlo.
+- **Una automatización** conserva su agente aunque luego lo quites del workspace (el editor lo marca **(not installed)**), pero sus runs se rechazan hasta que lo vuelvas a instalar o elijas otro agente. Si cambias el workspace de una automatización y el nuevo no tiene su agente, el editor pasa a uno que sí tenga y te lo indica.
+
+Para saber desde un script qué agentes puede usar un workspace, lee su campo `run_agents`: consulta [Referencia de la API → Workspaces](/es/docs/api#tag/workspaces).
+
 ## Lanza un run desde el portal
 
 <Steps>
@@ -45,7 +63,7 @@ Pulsa **New run** y rellena el formulario (el portal está en inglés):
 
 | Campo | Qué es |
 |---|---|
-| **Agent** | El agente: Pi o Hermes, el que tengas instalado en el workspace. |
+| **Agent** | El agente: **Pi**, **Pi + Gentle Shell** o **Hermes**. La lista solo muestra los agentes instalados en el workspace. Consulta [Elige el agente](#elige-el-agente). |
 | **Task** | La tarea, con tus palabras, como se la escribirías al agente en un chat. Hasta 32 KiB (el contador bajo la caja te dice los bytes que llevas). |
 | **Folder** | La carpeta donde trabaja el agente. Por defecto es `/home/nan` y tiene que estar dentro de ella. |
 | **Separate branch** | Rama aparte: **Auto** (por defecto), **On** u **Off**. En un repositorio git, el agente trabaja en su propia rama y tu checkout se queda como está. Consulta [Dónde trabaja el agente](#dónde-trabaja-el-agente). |
@@ -136,7 +154,7 @@ Los secretos que guardas en tus ajustes no se les dan a estos runs: solo llegan
 
 ## Desde la terminal: `nan run`
 
-La [CLI de NaN](/es/docs/nan-cli) lanza y sigue runs desde tu propia terminal. Necesitas la versión **0.1.25** o posterior: `nan --version` imprime `nan <versión>`.
+La [CLI de NaN](/es/docs/nan-cli) lanza y sigue runs desde tu propia terminal. Necesitas la versión **0.1.25** o posterior, y la **0.1.29** o posterior para `--agent pi_gentle`: `nan --version` imprime `nan <versión>`.
 
 <Steps>
 
@@ -170,6 +188,9 @@ Otras formas de lanzarlo:
 # Un workspace, un agente y una carpeta concretos
 nan run --ws develop --agent hermes --cwd /home/nan/projects/api "revisa los TODO pendientes"
 
+# Pi + Gentle Shell (el workspace necesita Pi y gentle-shell)
+nan run --ws develop --agent pi_gentle "refactoriza el cargador de configuración sin romper los tests"
+
 # La tarea desde un archivo, o desde stdin
 nan run -f tarea.md
 git diff | nan run -
@@ -181,7 +202,7 @@ nan run --detach "actualiza las dependencias"
 | Flag | Por defecto | Qué hace |
 |---|---|---|
 | `--ws NAME` | tu único workspace | El workspace donde se ejecuta. Si tienes más de uno y no lo pones, la CLI te los lista y sale con código 64. |
-| `--agent pi\|hermes` | `pi` | El agente. |
+| `--agent pi\|pi_gentle\|hermes` | `pi` | El agente: `pi` (Pi), `pi_gentle` (Pi + Gentle Shell) o `hermes` (Hermes). Tiene que estar instalado en el workspace. Consulta [Elige el agente](#elige-el-agente). |
 | `--model M` | el del agente | El modelo que usa el agente. |
 | `--cwd PATH` | `/home/nan` | La carpeta en el workspace. |
 | `--worktree` / `--no-worktree` | auto | Fuerza la rama aparte a on u off. Consulta [Dónde trabaja el agente](#dónde-trabaja-el-agente). |
@@ -345,6 +366,19 @@ fi
 
 Los campos equivalen al formulario del portal: **Agent** es `agent`, **Task** es `prompt`, **Folder** es `cwd`, y los opcionales **Separate branch** y **Time limit** son `git_isolation` y `timeout_seconds`.
 
+`agent` es `pi`, `pi_gentle` o `hermes`, como en [Elige el agente](#elige-el-agente). Si el workspace no tiene ese agente instalado, no se crea ningún run y el ejemplo imprime el error:
+
+```json
+{
+  "error": {
+    "message": "Pi + Gentle Shell is not installed in this workspace",
+    "type": "invalid_request_error",
+    "param": "agent",
+    "code": "agent_not_installed"
+  }
+}
+```
+
 El stream manda un frame `run_event` por cada evento del log, un frame `state` cuando el run cambia de estado y un frame `end` con el run terminado, y después se cierra.
 
 Referencia completa: [Referencia de la API → Runs](/es/docs/api#tag/runs). Ahí están todos los endpoints (listar, consultar, cancelar), los campos de cada petición y respuesta, los tipos de evento, cómo retomar un stream, los reintentos idempotentes y todos los códigos de error. Para sacar el nombre o el id de un workspace desde un script, consulta [Referencia de la API → Workspaces](/es/docs/api#tag/workspaces).

diff --git a/src/content/docs-es/workspaces.mdx b/src/content/docs-es/workspaces.mdx
@@ -211,13 +211,13 @@ El panel **Software**, en la pestaña Overview del workspace, lista los agentes
 - **Actualizar** uno, o todos a la vez, cuando sale una versión nueva. Las actualizaciones conservan tus archivos, sesiones y ajustes.
 - **Quitar** uno que ya no uses.
 
-gentle-shell es un complemento de Pi (memoria entre sesiones con Engram), así que necesita Pi instalado. Si tu Pi es demasiado antiguo, el panel te ofrece actualizarlo primero.
+gentle-shell es un complemento de Pi (memoria entre sesiones con Engram), así que necesita Pi instalado. Si tu Pi es demasiado antiguo, el panel te ofrece actualizarlo primero. Con los dos instalados, los runs y las automatizaciones también pueden usar **Pi + Gentle Shell**: consulta [Elige el agente](/es/docs/runs#elige-el-agente).
 
 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.
+No hace falta que te quedes conectado mientras un agente trabaja. Un **run** le da una tarea a un agente instalado en tu workspace (Pi, Pi + Gentle Shell o Hermes) 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).
 

diff --git a/src/content/docs/automations.mdx b/src/content/docs/automations.mdx
@@ -23,7 +23,7 @@ The agent of an automation does not push or post on its own. It **proposes actio
 
 ## Before you start
 
-- **A workspace that is running**, with Pi or Hermes installed, as for any [run](/docs/runs#before-you-start).
+- **A workspace that is running**, with the agent you want installed (Pi, Pi + Gentle Shell or Hermes), as for any [run](/docs/runs#pick-the-agent).
 - **A plan with inference.** Automation runs use your workspace's inference key and count against your plan's usage like any other run.
 - **A browser sign-in.** Creating or changing automations, writing secrets and approving actions need you signed in at [cloud.nan.builders](https://cloud.nan.builders/) in your browser, with the email link. A CLI session, an API key or a token can list automations and run them, but never change them. See [Why some actions need the browser](#why-some-actions-need-the-browser).
 - **For the GitHub templates, a GitHub token saved as a secret.** The automation cannot be saved without it, so create it first: see [A GitHub token for actions](#a-github-token-for-actions).
@@ -58,7 +58,7 @@ The three GitHub templates act on a repository, so they need a **GitHub reposito
 | **Description (optional)** | For you. |
 | **Instructions** | What the agent must do, up to 16 KiB. Your instructions are trusted. Whatever a webhook or a manual run sends is given to the agent as data, never as instructions. |
 | **Workspace** | The workspace the agent runs in. |
-| **Agent** | Pi or Hermes. |
+| **Agent** | **Pi**, **Pi + Gentle Shell** or **Hermes**. Only the agents installed in the chosen **Workspace**, so pick the workspace first. An agent removed from the workspace later shows as **(not installed)** and its runs are refused with `agent_not_installed`. See [Pick the agent](/docs/runs#pick-the-agent). |
 | **Folder** | Where the agent works, inside `/home/nan`. Not used with **Fresh clone per run**. |
 | **Separate branch** | **On** (the default), **Auto** or **Off (work in the folder directly)**, as in a [run](/docs/runs#where-the-agent-works). Not used with **Fresh clone per run**. |
 | **Time limit (minutes)** | From 1 to 120. 30 by default. |

diff --git a/src/content/docs/pr-gatekeeper.mdx b/src/content/docs/pr-gatekeeper.mdx
@@ -90,7 +90,7 @@ And how it behaves:
 ## Before you start
 
 - **A running workspace with your repository's toolchain.** The agent runs the tests in one of your [workspaces](/docs/workspaces), so it needs what your CI needs: Go, Node, Python... Install them once in the workspace, as you would on your laptop, and keep it running: a stopped workspace cannot start runs, and the events that arrive meanwhile are lost. The example uses a workspace called `work` with Go installed.
-- **Pi or Hermes installed in that workspace**, from its [Software panel](/docs/workspaces#agents-and-the-software-panel). The example uses Pi.
+- **The agent installed in that workspace**: Pi, Pi + Gentle Shell or Hermes, from its [Software panel](/docs/workspaces#agents-and-the-software-panel). The automation can only use an agent the workspace has (see [Pick the agent](/docs/runs#pick-the-agent)). The example uses Pi.
 - **A plan with inference.** Each review is an [agent run](/docs/runs) and uses your plan like any other request.
 - **Admin access to the repository on GitHub**, to add the webhook and create the tokens.
 - **A browser sign-in at [cloud.nan.builders](https://cloud.nan.builders/)**, with the email link: creating automations and saving secrets need it.