--- name: reboot_all_claudes kind: function lang: bash domain: infra version: "1.0.0" purity: impure signature: "reboot_all_claudes([--go|--yes] [--resume-mode resume|continue|none] [--exclude-current] [--only-idle] [-h|--help])" description: "Cierra todas las terminales kitty con una sesion de Claude Code corriendo y las relanza retomando la misma sesion (claude --resume ). Mapea cada PID vivo a su ~/.claude/sessions/.json para sacar sessionId, cwd y la ventana kitty. DRY-RUN por defecto; --go ejecuta de verdad de forma desacoplada." tags: [claude, session, terminal, kitty, reboot, infra, terminal-capture] uses_functions: [] uses_types: [] returns: [] returns_optional: false error_type: "error_go_core" imports: [] params: - name: "--go" desc: "Ejecuta de verdad: mata las ventanas kitty y relanza las sesiones (detached). Alias --yes. Sin esto es dry-run." - name: "--yes" desc: "Alias de --go." - name: "--resume-mode " desc: "Estrategia de reanudacion. resume (default): claude --resume . continue: claude --continue. none: sesion nueva en el mismo cwd." - name: "--exclude-current" desc: "No cierra ni relanza la terminal desde la que se invoca. Detecta el claude propio subiendo por la cadena de PPIDs hasta hallar un ancestro con comm=claude." - name: "--only-idle" desc: "Omite las sesiones con status busy (no pierde el turno en vuelo). Por defecto se incluyen todas y el dry-run avisa cuales estan busy." - name: "-h|--help" desc: "Muestra el uso y termina." output: "Imprime una tabla del plan (PID, KITTY_PID, status, accion, sessionId, cwd) y el comando claude exacto por sesion. En dry-run no toca nada. Con --go lanza un script desacoplado en /tmp que cierra ventanas y relanza. Exit 0 normal; exit 2 si flags invalidos." tested: false tests: [] test_file_path: "" file_path: "bash/functions/infra/reboot_all_claudes.sh" notes: "Mecanismo (Claude Code 2.1.x sobre Linux + kitty): pgrep -x claude -> PIDs vivos; ~/.claude/sessions/.json -> sessionId/cwd/status/procStart; anti-PID-reciclado comparando procStart del JSON con el campo 22 de /proc//stat; KITTY_PID del environ -> ventana a cerrar con SIGTERM; cmdline -> flags conservados (sin argv0 ni resume previos). El relanzamiento usa setsid kitty --directory zsh -ic 'claude ...; exec zsh'. Como la propia terminal es una victima, el plan --go se escribe a /tmp y se lanza con setsid para sobrevivir al cierre del padre." --- ## Ejemplo ```bash # Dry-run (default seguro): ver el plan sin tocar nada. reboot_all_claudes # Reiniciar de verdad todas las sesiones MENOS la terminal actual. reboot_all_claudes --go --exclude-current # Reiniciar solo las sesiones idle (no perder turnos en vuelo), de verdad. reboot_all_claudes --go --only-idle # Arrancar sesiones nuevas (sin reanudar la conversacion) en cada cwd. reboot_all_claudes --go --resume-mode none ``` ## Cuando usarla Tras actualizar Claude Code (para que todas las sesiones corran la version nueva), o cuando varias sesiones se cuelgan y quieres reiniciarlas todas de golpe retomando exactamente la conversacion donde estaba cada una. Lanza siempre primero sin flags para revisar el plan; luego repite con `--go`. ## Gotchas - **Es impura y se auto-mata.** La terminal desde la que la invocas suele ser una de las victimas; por eso el modo `--go` escribe un script a `/tmp/reboot_all_claudes...sh` y lo lanza con `setsid` para que el reparenting a init garantice los relanzamientos aunque el padre muera. Usa `--exclude-current` si quieres conservar la terminal actual. - **Sesiones `busy` pierden el turno en vuelo.** Por defecto se reinician igual y el dry-run lo avisa explicitamente. Al reanudar con `--resume` se recupera hasta el ultimo mensaje completo guardado en el `.jsonl`. Usa `--only-idle` para no tocarlas. - **Depende de `~/.claude/sessions/.json`** (formato de Claude Code 2.1.x). Si una version futura cambia el formato, la funcion deja de mapear PID -> sessionId y omitira las sesiones. - **Asume kitty como terminal.** Si un claude corre fuera de kitty (sin `KITTY_PID` en el environ, p.ej. terminal integrado de un editor), el fallback mata directamente el PID de claude y abre una kitty nueva en su `cwd`. - **Anti-PID-reciclado:** valida `procStart` del JSON contra el campo 22 de `/proc//stat`; si no coincide (o el JSON no existe, o `kill -0` falla) la sesion se omite como huerfana.