Cosmic CLI

¿Qué es Cosmic CLI?

Cosmic CLI es una interfaz de línea de comandos impulsada por IA que lleva las capacidades de la plataforma Cosmic a un flujo de trabajo en terminal. Está diseñada para ayudarte a crear aplicaciones, gestionar contenido, desplegar en producción y ejecutar u orquestar agentes de IA sin salir de tu línea de comandos.

En lugar de depender solo del panel de Cosmic, la CLI ofrece modos de comandos interactivos y asistidos por IA para realizar tareas de varios pasos —como generar una app lista para producción con configuración de repositorio y despliegue— mediante comandos en lenguaje natural y flujos de trabajo estructurados.

Características principales

• Instalación en un comando y uso global de la CLI: Instala la CLI globalmente (con npm o bun) para ejecutar capacidades de Cosmic desde tu terminal.
• Navegación interactiva en shell con conciencia de espacio de trabajo: Inicia una sesión interactiva con historial de comandos, prompts conscientes del espacio de trabajo, navegación estilo sistema de archivos y capacidad para ejecutar comandos del sistema con un prefijo configurado.
• Modos de chat IA con contexto de contenido: Usa modos conversacionales con conciencia completa del contexto de tu contenido, con flags para proporcionar contexto adicional en operaciones de IA.
• Generación de apps en lenguaje natural con configuración de repo: Describe lo que quieres construir; la CLI genera una aplicación lista para producción conectada a tu proyecto Cosmic y prepara un repositorio de GitHub para el despliegue.
• Actualizaciones de código impulsadas por IA desde tu repositorio: Conéctate a un repositorio existente para que un Code Agent analice tu código, cree una rama de características y confirme cambios basados en tus instrucciones.
• Automatización de despliegues en Vercel: Despliega directamente en Vercel con gestión de variables de entorno, manejo de dominios personalizados, despliegues de vista previa y lanzamientos en producción, incluyendo streaming de logs en tiempo real.
• Control de CLI para agentes de IA y flujos de trabajo: Crea, ejecuta y gestiona los tres tipos de agentes desde la terminal, incluyendo captura de sesiones de autenticación en navegador para Computer Use Agents, aprobación de operaciones pendientes y encadenamiento de agentes en AI Workflows con monitoreo paso a paso.
• Gestión de repositorios y variables de entorno: Gestiona repositorios de GitHub, ramas, pull requests, variables de entorno y dominios personalizados, configurando automáticamente entornos locales con las claves API correctas de Cosmic (incluyendo variantes específicas de Next.js).
• Múltiples proveedores de modelos de IA: Selecciona entre varios proveedores de IA y establece un modelo predeterminado (ejemplos incluyen Claude vía Anthropic, GPT vía OpenAI y Gemini vía Google).

Cómo usar Cosmic CLI

1. Instala la CLI globalmente usando el método que prefieras (el artículo menciona npm y bun).
2. Autentícate usando uno de los dos métodos compatibles: autenticación de usuario para acceso completo al panel o autenticación con clave de bucket para acceso rápido a un bucket específico.
3. Inicia una sesión interactiva o usa comandos directos para trabajar en tu espacio de trabajo de Cosmic.
4. Crea o actualiza proyectos usando comandos en lenguaje natural para generación de apps o conectándote a un repositorio Git existente para cambios de código asistidos por IA.
5. Despliega en Vercel desde la CLI, incluyendo despliegues de vista previa y lanzamientos en producción, con configuración de variables de entorno y dominios manejada por la CLI.
6. Ejecuta agentes de IA y flujos de trabajo desde la terminal, monitoreando el progreso de ejecución y aprobando operaciones pendientes cuando sea necesario.

Casos de uso

• De idea a app en vivo (incluyendo contenido y despliegue): Genera una aplicación lista para producción conectada a tu proyecto Cosmic, con un repositorio de GitHub y un despliegue en vivo en Vercel creado en un flujo de extremo a extremo único.
• Mantén y escala operaciones de contenido: Usa creación de contenido impulsada por IA para producir objetos estructurados correctamente en tu bucket de Cosmic, y emplea el modo de chat de contenido interactivo para tareas continuas.
• Modifica un código base existente con cambios listos para revisión: Apunta la CLI a tu repositorio para que el Code Agent cree una rama de características y confirme cambios basados en instrucciones, luego abra un pull request y despliegue una vista previa.
• Actualiza configuración de entorno y despliega de forma confiable: Usa la CLI para gestionar variables de entorno y dominios personalizados durante despliegues, mientras transmites logs para rastrear el progreso.
• Coordina tareas de IA de varios pasos desde la terminal: Ejecuta los tipos de agentes compatibles y encadénalos en AI Workflows, revisando el progreso de cada paso y cancelando ejecuciones cuando sea necesario.

Preguntas frecuentes

• ¿Cosmic CLI requiere usar el panel de Cosmic? No. La CLI está diseñada para llevar las capacidades de Cosmic a tu terminal, incluyendo gestión de contenido, creación de apps, despliegue y orquestación de agentes.

• ¿Cómo maneja la CLI la autenticación? La CLI soporta dos métodos: autenticación de usuario (acceso completo al panel) y autenticación con clave de bucket (acceso rápido a un bucket específico sin iniciar sesión).

• ¿Qué tipos de interacciones con IA están disponibles desde la CLI? La CLI incluye modos de chat con IA con contexto de contenido y soporta agentes de IA y Flujos de trabajo de IA que se pueden controlar desde la terminal.

• ¿Puede la CLI desplegar en Vercel? Sí. La CLI incluye integración nativa con Vercel para gestión de variables de entorno, despliegues de vista previa, lanzamientos de producción, dominios personalizados y streaming de logs en tiempo real.

• ¿Hay límites basados en planes para el uso de la CLI? El artículo indica que Cosmic CLI respeta los mismos límites basados en planes que el panel, incluyendo límites para Agentes de IA.

Alternativas

• Integración basada en API (escribe tus propios scripts): Si prefieres control total, puedes crear tus propios scripts de terminal alrededor de las APIs de Cosmic para operaciones de contenido, automatización de repositorios y despliegues; esto intercambia conveniencia por personalización.
• Asistentes de codificación con IA de propósito general en tu IDE: Los asistentes de codificación enfocados en IDE pueden ayudar con cambios de código, pero no cubren directamente la estructuración de contenido específica de Cosmic, preparación de repositorios y flujos de despliegue en Vercel.
• Herramientas de automatización de flujos de trabajo (plataformas CI/CD y de orquestación): Las herramientas que orquestan trabajos y despliegues pueden automatizar partes del flujo, pero necesitarías pasos adicionales para generar contenido estructurado de Cosmic y coordinar interacciones de agentes.
• Gestión de contenido y apps centrada en el panel: Quedarte en el panel de Cosmic es una alternativa cuando quieres herramientas visuales, aunque no proporciona el shell interactivo impulsado por terminal, automatización de repos/depliegues o flujos de agentes controlados por CLI descritos aquí.