Remoto
Gestiona máquinas remotas definidas en infra/remotes/*.yaml.
Lee el archivo referenciado solo cuando se activa.
Guarda
remotes.enabled debe ser true en bridge-config.yaml. Si no: informar y salir.
Argumentos
| Argumento | Efecto | Por defecto |
|---|---|---|
(ninguno) | Panel de control de todos los remotos | — |
{hostname} | Vista detallada de un remoto | — |
health {hostname} | Verificación de salud SSH | — |
logs {hostname} {service} | Mostrar registros recientes | — |
restart {hostname} {service} | Reiniciar servicio | — |
sync {hostname} | Sincronizar archivos de configuración | — |
wake {hostname} | Wake-on-LAN | — |
connect {hostname} | Abrir sesión SSH / RDP | — |
shutdown {hostname} | Apagar (requiere [y]) | — |
reboot {hostname} | Reiniciar máquina (requiere [y]) | — |
Árbol de decisión
El usuario quiere...
├── Resumen / panel de control remoto → Leer references/workflow.md (§ Dashboard)
├── Vista detallada de una máquina → Leer references/workflow.md (§ Dashboard, host único)
├── Activar / encender una máquina → Leer references/fleet.md (§ Etapa 3 WoL)
├── Conectar vía SSH / RDP → Leer references/fleet.md (§ Etapa 4 Conectar)
├── Reiniciar o apagar → Leer references/fleet.md (§ Etapa 5)
├── Verificar accesibilidad / en línea? → Leer references/fleet.md (§ Etapa 2)
├── Actualizar inventario tras un cambio → Leer references/fleet.md (§ Etapa 6)
├── Verificación de salud para máquina → Leer references/workflow.md (§ Health Check)
├── Ver registros de servicio → Leer references/workflow.md (§ Logs)
├── Reiniciar un servicio → Leer references/workflow.md (§ Restart)
├── Sincronizar configuración a remoto → Leer references/workflow.md (§ Sync)
├── Desplegar servicios en un remoto → Leer references/workflow.md (§ Deploy)
├── Identificar "mi PC" / solo intención → Leer references/fleet.md (§ Etapa 1 + Enrutamiento aprendido)
└── Preguntas sobre remotos → Responder desde CLAUDE.md § Remotes
Mapa de referencias
| Archivo | Propietario |
|---|---|
references/fleet.md | Inventario, WoL, conectar, apagar, accesibilidad, enrutamiento "mi PC" |
references/workflow.md | Panel de servicio, salud, registros, reinicio, sincronización, despliegue |
Reglas estrictas (no negociables)
- Tailscale primero, LAN como alternativa — LAN falla en VPN o redes externas
- Sin operación destructiva (apagar, reiniciar, formatear) sin
[y]por acción - Nunca almacenes credenciales en
infra/remotes/*.yaml— solo URIs de KeyVault / 1Password - Respeta
wake_on_lan.enabled: false— nunca fuerces a despertar una máquina que optó por no hacerlo - Lee
infra/remotes/{target}.yamlantes de cualquier operación — sin adivinanzas