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) 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:

/plugin marketplace add obra/superpowers-marketplace

Paso 2: sigue la instalación oficial

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:

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:

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.