Skip to main content
@insforge/cli es la interfaz que un agente de codificación utiliza para operar su backend. Donde un humano se dirige al panel, el agente se dirige a la terminal: ejecuta un comando, lee el resultado y decide qué hacer a continuación. Cada comando habla --json, por lo que el agente funciona con datos estructurados en lugar de raspar una pantalla.
Ejecute la CLI con npx @insforge/cli. No lo instale globalmente, para que el agente siempre use la versión fijada al proyecto.

Por qué una CLI para agentes

Un panel se construye para un puntero humano; una CLI se construye para cualquier cosa que pueda escribir texto. Pase --json a cualquier comando y el agente obtiene un resultado estructurado que puede analizar; pase --yes y se ejecuta sin detenerse en un indicador de confirmación. El esquema, la configuración de autenticación, el almacenamiento, las funciones, las implementaciones, las ramas y los diagnósticos son todos subcomandos de la misma herramienta, por lo que hay una superficie para aprender en lugar de un panel para navegar. Se ejecuta en cualquier terminal, cualquier editor o CI, sin necesidad de configurar una integración. Y después de un cambio, el agente puede ejecutar npx @insforge/cli diagnose y leer exactamente qué se rompió.

Superficie de comando

Ejecute npx @insforge/cli help <command> para las banderas en cualquiera de estos.

Actualizar y eliminar un proyecto

projects update-version mueve el proyecto a la última versión del backend de InsForge. Apunta al proyecto vinculado de forma predeterminada; pase --project <id> para elegir otro. El comando reinicia la instancia, así que espere una breve interrupción. Añada --wait para bloquear hasta que la actualización termine. projects delete elimina permanentemente el proyecto: su base de datos, almacenamiento y todos los demás recursos, incluidas sus ramas de backend. Aquí --project es obligatorio y nunca recurre al proyecto vinculado, de modo que un valor de entorno perdido no pueda apuntar la eliminación al proyecto equivocado. Ambos comandos confirman antes de actuar, pero solo en modo interactivo: --yes y --json omiten el indicador, así que projects delete --project <id> --json elimina de inmediato. La eliminación es irreversible. Nunca pase --yes aquí, y haga que un humano verifique el id exacto del proyecto antes de ejecutar el comando. Para hacer cualquiera de las dos desde el panel en su lugar, ambas se encuentran en Settings → General.

Una ejecución de agente típica

Deje que el agente interprete la salida

Los diagnósticos incluyen una bandera de IA para que el agente pueda entregar sus propios datos de backend a un modelo y obtener una explicación:
Esto empareja las señales sin procesar (hallazgos del asesor, salud de DB, registros de errores) con una lectura en lenguaje natural, que es lo que convierte “aquí hay un seguimiento de pila” en “aquí está la solución”. Ver Diagnósticos y asesor.

Próximos pasos

  • Coloque la configuración de autenticación, SMTP, almacenamiento, retención e implementación en control de versiones con configuración como código.
  • Pruebe cambios arriesgados en una rama de backend antes de tocar la producción.