# Instrucciones para el agente: Claude Session Driver: supervisa sesiones de agentes en tmux

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: intermedio
- Proyecto: https://github.com/obra/claude-session-driver (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/claude-session-driver

---

## 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: prepara el entorno

Comprueba que puedes abrir Claude Code y que tmux, Node.js ≥22.12.0 (mínimo de [package.json](https://github.com/obra/claude-session-driver/blob/main/package.json)) y el CLI del arnés elegido están disponibles. Dentro de Claude Code, registra primero el catálogo de plugins con el comando del [marketplace oficial](https://github.com/obra/superpowers-marketplace#installation):

```text
/plugin marketplace add obra/superpowers-marketplace
```

### Paso 2: sigue la instalación oficial

```bash
claude plugin install claude-session-driver@superpowers-marketplace
```

## Comprobación

Dentro de Claude pide consultar la skill `driving-claude-code-sessions`. Su CLI no se instala necesariamente en PATH: está en `skills/driving-claude-code-sessions/scripts/csd` dentro del plugin. Obtén la ruta real del plugin instalado y sustituye el marcador del siguiente bloque; los subcomandos son los del README:

```bash
CSD="/ruta/al/plugin/skills/driving-claude-code-sessions/scripts/csd"
"$CSD" help
"$CSD" grant-consent
```

Revisa el consentimiento inicial: los trabajadores pueden omitir solicitudes de permisos. En un proyecto de ensayo, tras aceptar ese alcance:

```bash
CSD_WORKER=$("$CSD" launch prueba /ruta/absoluta/al/proyecto-de-ensayo)
"$CSD_WORKER" converse "Lee el README y devuelve su título, sin editar archivos" 60
"$CSD_WORKER" read-turn
"$CSD_WORKER" read-events --last 10
"$CSD_WORKER" stop
```

Compara el título con el archivo real y verifica el cierre del trabajador. El lanzador devuelve una ruta de control; no un identificador que deba inventarse.

## Si algo falla

Si el catálogo ya está registrado pero desactualizado, el README indica `claude plugin marketplace update superpowers-marketplace`. Comprueba después tmux y el CLI seleccionado; consulta los comandos status y read-events documentados.

[Fuente de los comandos y del procedimiento](https://github.com/obra/claude-session-driver#readme).