saltar al contenido principal
Explorar la documentación

syncanix init

Descubre tu API, construye el catálogo de capacidades y lo sube, con enriquecimiento por IA sujeto a consentimiento.

init es el comando que más usarás. Analiza tu proyecto, convierte tu API en un catálogo de capacidades y lo sube a tu espacio de trabajo.

npx syncanix init

Opciones

-f, --framework <name>
Fuerza un framework en lugar de detectarlo automáticamente (nestjs, express, fastapi, nextjs, graphql).
--offline
Escribe el catálogo localmente sin subirlo.
-y, --yes
Acepta los valores por defecto y omite las preguntas (asume el consentimiento de enriquecimiento gestionado).

Qué hace

  1. Detecta tus frameworksAnaliza el proyecto e informa de cada framework que reconoce, no solo del principal.
  2. Extrae capacidadesLee tus rutas y construye una lista estructurada de capacidades, con sus entradas y efectos.
  3. Aplica .syncanixignoreDescarta todo lo que coincida con tus reglas de exclusión antes de escribirlo, enriquecerlo o subirlo.
  4. Pregunta por el enriquecimiento con IAMuestra una estimación de coste y pregunta cómo quieres proceder antes de enviar texto de código a un proveedor.
  5. Escribe el catálogoGuarda un archivo .syncanix/catalog.json determinista que puedes revisar y versionar.
  6. Lo subeEnvía el catálogo a tu espacio de trabajo, salvo que hayas pasado --offline o aún no tengas clave de API.

Estático por defecto

El descubrimiento lee tu código; nunca lo ejecuta, y ningún dato de producción sale de tu máquina. Lo único que puede enviarse es el catálogo estructurado, y el enriquecimiento con IA solo ocurre con tu consentimiento explícito.

El enriquecimiento con IA redacta títulos y descripciones más claros para tus capacidades. Antes de enviar nada, la CLI muestra exactamente qué se enviaría (identificadores de capacidad, métodos y rutas, nombres de argumentos y un breve extracto del manejador con los secretos redactados) y qué no (archivos de código, tus datos, secretos, cualquier cosa ignorada). Luego eliges un modo:

Gestionado
Usa la clave de proveedor de Syncanix bajo un contrato de cero retención de datos.
BYOK
Usa tu propia clave de proveedor; el texto del manejador va directamente de tu máquina al proveedor, y Syncanix nunca lo ve.
Omitir
Sin enriquecimiento: entrega solo los metadatos del extractor y enriquece más tarde desde el panel.

Próximos pasos