cli

# Opaline CLI Opaline CLI es una herramienta de línea de comandos que captura sesiones de Claude Code y OpenAI Codex y las sube a la plataforma Opaline para análisis de equipo. La API de producción está alojada en `https://opaline.so`. Anteriormente se conocía como `rudel` y mantiene compatibilidad con ese nombre. ## Inicio rápido Requiere Node.js 20 o superior. Ejecute `npx opaline@latest` desde cualquier directorio. La CLI escanea las sesiones locales de Claude Code y Codex, muestra los recuentos de repositorios y sesiones, y le permite elegir qué repositorios subir y mantener sincronizados. El inicio de sesión solo se abre después de la selección. `pnpx opaline@latest` también funciona; una instalación global es opcional. Copiar el comando desde la demostración de Opaline agrega un valor oculto `--code`. Ese código de un solo uso vincula el terminal con su navegador para la selección en vivo y el estado de la subida. Caduca después de diez minutos si no se usa. Apruebe el inicio de sesión en el mismo navegador donde copió el comando. Las primeras subidas continúan con la configuración del navegador; los usuarios que regresan abren la página de Sesiones de su espacio de trabajo. Las subidas automáticas conservan la CLI incluida en `~/.rudel/runtime` y usan su ejecutable de Node, por lo que los hooks siguen funcionando después de que la caché temporal del ejecutor desaparezca. `opaline login` abre un flujo de dispositivo basado en navegador. `opaline upload` agrupa los worktrees locales por repositorio, le permite elegir qué repositorios permanecen sincronizados, instala los hooks requeridos de Claude Code y/o Codex, y sube nuevas sesiones. Abra la misma tabla para activar o desactivar repositorios. Los usuarios existentes de `rudel` no necesitan iniciar sesión nuevamente. Opaline lee intencionalmente el directorio existente de credenciales y estado `~/.rudel`, y el paquete `rudel` continúa como un alias de compatibilidad. Ejecute `opaline upload` desde cualquier directorio, incluida su carpeta de inicio. El selector encuentra sesiones guardadas en todos los repositorios y sube los repositorios que seleccione. También habilita subidas automáticas para esas selecciones. El hook de Claude Code se instala en su configuración de usuario, por lo que la configuración no depende de su directorio actual. Los hooks y ajustes existentes se conservan. ## Flujo de trabajo típico Ejecute `opaline upload` (o `npx opaline@latest`) para abrir la tabla de repositorios. La tabla se llena durante el escaneo y luego muestra los recuentos de sesiones locales y ya subidas junto con los interruptores ON/OFF. La barra espaciadora cambia un repositorio; Enter abre una revisión con repositorios recién agregados, ya activos y desactivados. Enter confirma; Esc vuelve a la edición. El progreso de la subida permanece en la misma tabla. Los hooks existentes de Rudel se reconocen como habilitados. Guardar migra los hooks propios a Opaline, elimina los hooks locales duplicados y conserva los ajustes de agente no relacionados. Las herramientas de notificación de Codex pueden coexistir con las subidas automáticas. Opaline conserva el comando y los argumentos existentes, reenvía el JSON de notificación y sube de forma independiente. Codex Computer Use permanece al frente de su cadena de notificaciones. Desactivar las subidas mantiene las notificaciones funcionando. Los scripts personalizados se conservan; Opaline no reescribe scripts que invoquen instalaciones antiguas de Rudel. Los fallos de configuración muestran sus detalles completos y una acción de reintento/retroceso, incluido el archivo de configuración a corregir cuando una configuración de Codex no es válida. ## Conceptos clave - **Sesiones:** Transcripciones JSONL de Claude Code y Codex descubiertas en la máquina local. - **Hooks:** Comandos del ciclo de vida del agente instalados por `opaline upload` o `opaline enable`. Los hooks se ejecutan sin interfaz, consultan la lista de permitidos de repositorios, filtran patrones de secretos conocidos y suben la sesión completada. - **Organizaciones:** El espacio de trabajo de Opaline que recibe las subidas. Use `opaline set-org` para cambiar la organización asociada con un proyecto. - **Estado local:** Credenciales, colas de reintentos, registros y asignaciones de proyectos permanecen en `~/.rudel` para compatibilidad. Establezca `OPALINE_CONFIG_DIR` para optar por otro directorio; `RUDEL_CONFIG_DIR` sigue siendo compatible. - **Alias de compatibilidad:** El ejecutable `rudel` delega en la misma implementación de Opaline con argumentos, entrada/salida estándar y estado de salida sin cambios. Su única adición es un aviso de renombrado en stderr por invocación.