fn_registry/.claude/commands/fleet.md

description, argument-hint

description	argument-hint
Muestra la flota de Claudes vivos (sessionId + objetivo + estado) y, con argumento, salta con foco a esa conversación dentro de la sesión tmux fleet.	[texto|sessionId|PID para saltar — vacío = listar la flota]

/fleet — ver y navegar la flota de Claudes

Inspecciona la flota de procesos Claude Code vivos de este PC y, opcionalmente, salta con foco a cualquiera de ellos dentro de la interfaz tmux (perfil fleetview).

Se apoya en el modo CLI de la app fleetview (fleetview list / fleetview focus), que opera sobre el socket tmux del perfil desde el que se invoca el comando ($FLEET_SOCKET, default fleet). Es decir, lista y enfoca solo los Claudes del mismo perfil en el que corres.

Binario

Ruta: ${FN_REGISTRY_ROOT:-$HOME/fn_registry}/apps/fleetview/fleetview

Si el binario no existe, compílalo antes de usarlo:

cd "${FN_REGISTRY_ROOT:-$HOME/fn_registry}/apps/fleetview" && go build -o fleetview .

Comportamiento según $ARGUMENTS

Sin argumentos → listar la flota

1. Ejecuta:

   "${FN_REGISTRY_ROOT:-$HOME/fn_registry}/apps/fleetview/fleetview" list --json
   

2. Presenta el resultado como una tabla legible para el usuario, una fila por Claude, con: estado (idle/busy/waiting/shell), objetivo (goal), sessionId corto (primeros 8 caracteres), PID y window tmux.
3. Marca con claridad:
   • el Claude activo (active: true) — el que está embebido en el pane derecho de la window console.
   • la sesión actual / orquestador si la puedes identificar (su session_id coincide con el de quien invoca).
4. Si la lista está vacía, indícalo y sugiere que el perfil fleet podría no estar activo (revisar $FLEET_SOCKET y que la sesión tmux exista).

Con argumentos → saltar con foco

El usuario quiere que la interfaz tmux salte a una conversación concreta. $ARGUMENTS es el query: texto del objetivo, prefijo de sessionId, o PID.

1. Ejecuta:

   "${FN_REGISTRY_ROOT:-$HOME/fn_registry}/apps/fleetview/fleetview" focus "$ARGUMENTS"
   

2. Interpreta el exit code:
   • 0: salto hecho. Confirma al usuario a qué Claude saltó (usa la línea → ... de stdout).
   • 2: query ambiguo. El binario lista los candidatos por stderr; muéstralos y pide al usuario que afine (por sessionId o PID).
   • 1: sin match o sin window tmux. Ejecuta fleetview list y muestra las opciones disponibles para que elija.

Notas

• El salto usa el modelo de la TUI: trae el Claude elegido al pane derecho de la window console (con el sidebar fleetview siempre visible a la izquierda) y enfoca esa window. No es destructivo — el Claude que estuviera antes se aparca en su propia window, sigue vivo.
• El comando opera solo sobre el perfil tmux desde el que se invoca ($FLEET_SOCKET). Si pides un Claude que vive en otro perfil/socket, no aparecerá en la lista ni se podrá enfocar desde aquí.
• Para reabrir sesiones cerradas (claude --resume) usa la TUI fleetview (tecla u); este comando solo lista y enfoca Claudes vivos.