# Instrucciones para el agente: Hermes en Cua Spaces: ejecuta herramientas en una máquina aislada

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/trycua/hermes-cua-spaces (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/hermes-cua-spaces

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: instala Cua

Comprueba que tu Hermes admite plugins y usa Python ≥3.11. El manifiesto del plugin requiere el paquete Python `cua` ≥0.5.0 y <0.8; el instalador ofrece prepararlo. Para aislar también navegador y escritorio, el README exige un Space Linux, Cua ≥0.7.0 y un Hermes que incluya el cambio #142225 (posterior a v0.22.2), además de los componentes del escritorio indicados allí. Revisa el instalador oficial antes de ejecutarlo:

```bash
curl -fsSL https://cua.ai/install.sh | sh
```

Para Spaces vinculados a tu cuenta:

```bash
cua auth login
```

### Paso 2: añade el plugin a Hermes

```bash
hermes plugins install https://github.com/trycua/hermes-cua-spaces
hermes config set terminal.backend cua
```

Revisa y acepta la dependencia Python cua y la activación cuando el instalador lo solicite.

### Paso 3: inicia Hermes y prueba la ubicación

Pide a Hermes el ejemplo de comprobación del README: `run hostname and cat /etc/os-release` en un Space Linux.

## Comprobación

La salida debe identificar la máquina del Space. Usa `cua spaces ls` para localizarla. Comprueba por separado terminal, archivos y navegador; no des por hecho que comparten aislamiento.

## Si algo falla

El README documenta `cua doctor` para requisitos y `hermes pm repair` si falta el paquete Python. Si los archivos desaparecen al cerrar, revisa delete_on_exit y la elección entre máquina temporal o Space con nombre.

Fuente: [documentación oficial](https://github.com/trycua/hermes-cua-spaces#readme).