Más comandos de la CLI

Más allá de init, la CLI cubre cuatro tareas: iniciar sesión y elegir espacio de trabajo, comprobar qué está realmente en producción, escribir tu integración por ti y leer la configuración de tu espacio desde una terminal o un trabajo de CI.

Iniciar y cerrar sesión

Inicia sesión con tu navegador: la CLI abre el panel, apruebas el dispositivo y una sesión vinculada a tu cuenta se guarda en ~/.syncanix/credentials (legible solo por ti); la CLI actúa entonces con tu rol, en tus espacios de trabajo. Usa --key para una clave de máquina del espacio de trabajo (CI; aprobación de administrador), comprueba con qué cuenta estás con syncanix whoami y cierra sesión con syncanix logout, que además revoca la sesión en el servidor.

npx syncanix login
npx syncanix logout

Comprueba quién eres y dónde estás escribiendo

Una sesión actúa como tú, así que el mismo comando puede escribir en un espacio de trabajo distinto según cuál esté activo. syncanix whoami responde a ambas preguntas a la vez: tu identidad, el espacio de trabajo activo y tu rol en él, cuándo caduca la sesión y todos los espacios en los que puedes actuar. Lo resuelve en vivo desde el servidor, así que también sirve para comprobar que tu sesión sigue siendo válida. syncanix workspace list muestra esa misma lista por separado, y syncanix workspace use <slug> cambia dónde escribirá el siguiente comando. Ejecuta whoami antes de cualquier cosa que suba datos.

npx syncanix whoami
npx syncanix workspace list
npx syncanix workspace use acme

Importar un esquema

¿Ya tienes un esquema OpenAPI o GraphQL? Construye un catálogo directamente a partir de él, sin analizar el código. Pasa --offline para omitir la subida, o --env para apuntar a un entorno.

npx syncanix import --openapi ./openapi.json
npx syncanix import --graphql ./schema.graphql

¿Está sincronizada mi copia?

Compara lo que encuentra un escaneo nuevo de esta copia con lo que tu espacio de trabajo sirve ahora mismo, e imprime la diferencia. Es el comando al que acudir cuando el asistente hace algo inesperado: responde a «¿está producción ejecutando lo que creo?» sin abrir nada.

npx syncanix status

Detecta un cambio antes que tus clientes

Compara tu árbol de trabajo con el catálogo que has confirmado y sale con error si han divergido. Ponlo en tu canalización de integración continua y un cambio en algo de lo que depende el asistente romperá la compilación en vez de aparecer en una conversación.

npx syncanix drift

¿Está el widget realmente en la página?

Carga una URL e informa de si la inserción de Syncanix está activa en ella. Más rápido que abrir un navegador y útil en una comprobación de despliegue: la causa más habitual de que falte el chat es una compilación que perdió la etiqueta del script.

npx syncanix embed check https://app.acme.com

Escríbeme los archivos de integración

Escribe un pequeño conjunto de archivos de Syncanix en tu proyecto: la inserción, la configuración y lo que necesite tu stack. Solo crea archivos que no existan, así que ejecutarlo dos veces es seguro y nunca puede sobrescribir algo que hayas editado.

npx syncanix generate

Integra el widget en un frontend

Una versión guiada del mismo trabajo para un frontend existente, en cuatro pasos que ejecutas de uno en uno: escanea tu app, planifica el cambio, te muestra el plan para aprobarlo y solo entonces lo aplica.

npx syncanix integrate scan
npx syncanix integrate plan
npx syncanix integrate apply

Lee un catálogo desde la terminal

Lista lo que contiene un archivo de catálogo —filtrado por clase de riesgo, por método, por framework—, compara dos de ellos o exporta un informe de cumplimiento con cada capacidad, su riesgo y qué toca. Útil en revisión, y el informe es un documento que puedes entregar a quien lo pida.

npx syncanix catalog list --side-effect destructive
npx syncanix catalog diff ./before.json ./after.json
npx syncanix catalog compliance --format md

El mismo comando puede leer o cambiar el nombre y la descripción que se sirven al agente para una capacidad: el texto en lenguaje claro que ve quien aprueba una acción. Útil para arreglar una descripción torpe sin abrir el panel.

Consulta qué puede hacer el agente

Tres comandos de solo lectura para las preguntas de una auditoría: cada capacidad con si está activada y su clase de riesgo, cualquier cambio de capacidad a la espera de un segundo aprobador, y las claves de API que ha emitido tu espacio de trabajo, solo prefijos, nunca un secreto.

npx syncanix governance list
npx syncanix approvals
npx syncanix keys list

Entorno de desarrollo local

Ejecuta una página local que integra el widget contra un backend de desarrollo y se recarga en vivo cuando cambia tu catálogo. Las opciones permiten fijar el puerto, el origen del backend, la fuente del widget, la clave publicable y la ruta del catálogo.

npx syncanix dev --port 4321

Diagnostica tu configuración

Revisa tu entorno en busca de problemas habituales: versión de Node, un framework detectado, una configuración válida y una clave de API resoluble. Termina con un código distinto de cero si algo falla.

npx syncanix doctor

Registrar un servidor MCP externo

Si tu espacio de trabajo ya ejecuta su propio servidor MCP, regístralo para que Syncanix pueda reenviarle las llamadas a herramientas. Tendrás que haber iniciado sesión; la credencial se guarda de forma segura y nunca se muestra de vuelta.

npx syncanix byomcp register --server-url https://mcp.example.com

Superposiciones de catálogo como código

Gestiona una superposición syncanix.yaml versionada: init crea una, validate la comprueba y apply la fusiona sobre un catálogo descubierto.

npx syncanix yaml init
npx syncanix yaml validate
npx syncanix yaml apply --catalog ./.syncanix/catalog.json

Versión

Muestra las versiones de la CLI, de Node y de compilación, útil al informar de un problema.

npx syncanix version

Próximos pasos