Cosmic CLI

Cos'è Cosmic CLI?

Cosmic CLI è un'interfaccia a riga di comando basata su AI che porta le capacità della piattaforma Cosmic nel flusso di lavoro del terminale. È progettata per aiutarti a costruire applicazioni, gestire contenuti, distribuire in produzione ed eseguire o orchestrare agenti AI senza lasciare la riga di comando.

Invece di affidarti solo al dashboard Cosmic, la CLI offre modalità di comando interattive e assistite da AI per eseguire attività multi-step—come generare un'app pronta per la produzione con setup del repository e deployment—tramite comandi in linguaggio naturale e flussi di lavoro strutturati.

Caratteristiche Principali

• Installazione con un comando e utilizzo CLI globale: Installa la CLI globalmente (con npm o bun) per eseguire le capacità Cosmic dal tuo terminale.
• Navigazione workspace interattiva: Avvia una sessione interattiva con cronologia comandi, prompt consapevoli del workspace, navigazione in stile filesystem e possibilità di eseguire comandi di sistema con un prefisso configurato.
• Modalità chat AI con contesto contenuti: Usa modalità conversazionali con piena consapevolezza del contesto dei tuoi contenuti, con flag per fornire contesto aggiuntivo per le operazioni AI.
• Generazione app in linguaggio naturale con setup repo: Descrivi cosa vuoi costruire; la CLI genera un'applicazione pronta per la produzione connessa al tuo progetto Cosmic e prepara un repository GitHub per il deployment.
• Aggiornamenti codice basati su AI dal tuo repository: Connettiti a un repository esistente affinché un Code Agent analizzi il tuo codice, crei un branch di feature e commetta modifiche basate sulle tue istruzioni.
• Automazione deployment su Vercel: Distribuisci direttamente su Vercel con gestione variabili d'ambiente, domini personalizzati, deployment di preview e release in produzione, inclusi log in tempo reale.
• Controllo CLI per agenti AI e workflow: Crea, esegui e gestisci i tre tipi di agenti dal terminale, inclusa la cattura di sessioni di autenticazione browser per Computer Use Agents, approvazione operazioni in sospeso e collegamento agenti in AI Workflows con monitoraggio step-by-step.
• Gestione repository e variabili d'ambiente: Gestisci repository GitHub, branch, pull request, variabili d'ambiente e domini personalizzati, configurando automaticamente le impostazioni locali con le corrette API key Cosmic (incluse varianti specifiche per Next.js).
• Multipli provider di modelli AI: Seleziona tra vari provider AI e imposta un modello predefinito (esempi includono Claude via Anthropic, GPT via OpenAI e Gemini via Google).

Come Usare Cosmic CLI

1. Installa la CLI globalmente usando il metodo che preferisci (l'articolo menziona npm e bun).
2. Autentica usando uno dei due metodi supportati: autenticazione utente per accesso completo al dashboard o autenticazione con bucket key per accesso rapido a un bucket specifico.
3. Avvia una sessione interattiva o usa comandi diretti per lavorare nel tuo workspace Cosmic.
4. Crea o aggiorna progetti usando comandi in linguaggio naturale per la generazione app o connettendoti a un repository Git esistente per modifiche codice assistite da AI.
5. Distribuisci su Vercel dalla CLI, inclusi deployment di preview e release in produzione, con configurazione variabili d'ambiente e domini gestita dalla CLI.
6. Esegui agenti AI e workflow dal terminale, monitorando il progresso e approvando operazioni in sospeso dove necessario.

Casi d'Uso

• Da idea a app live (inclusi contenuti e deployment): Genera un'applicazione pronta per la produzione connessa al tuo progetto Cosmic, con repository GitHub e deployment live su Vercel creato tramite un flusso end-to-end unico.
• Mantieni e scala operazioni contenuti: Usa creazione contenuti basata su AI per produrre oggetti strutturati nel tuo bucket Cosmic, e modalità chat contenuti interattiva per task ongoing.
• Modifica codebase esistente con cambiamenti pronti per review: Punta la CLI al tuo repository affinché il Code Agent crei un branch di feature e commetta modifiche basate su istruzioni, poi apra una pull request e distribuisca una preview.
• Aggiorna configurazione ambiente e distribuisci in modo affidabile: Usa la CLI per gestire variabili d'ambiente e domini personalizzati durante i deployment, con streaming log per tracciare il progresso.
• Coordina task AI multi-step dal terminale: Esegui i tipi di agenti supportati e colleghiali in AI Workflows, rivedendo il progresso di ogni step e annullando esecuzioni quando necessario.

FAQ

• Cosmic CLI richiede l'uso del dashboard Cosmic? No. La CLI è pensata per portare le funzionalità di Cosmic nel tuo terminale, inclusa la gestione dei contenuti, la creazione di app, il deployment e l'orchestrazione degli agenti.

• Come gestisce l'autenticazione la CLI? La CLI supporta due metodi: autenticazione utente (accesso completo al dashboard) e autenticazione con bucket key (accesso rapido a un bucket specifico senza login).

• Che tipi di interazioni AI sono disponibili dalla CLI? La CLI include modalità di chat AI con contesto contenuti e supporta agenti AI e AI Workflows controllabili dal terminale.

• La CLI può distribuire su Vercel? Sì. La CLI include integrazione nativa con Vercel per la gestione delle variabili d'ambiente, deployment di preview, release in produzione, domini personalizzati e streaming log in tempo reale.

• Ci sono limiti basati sul piano per l'uso della CLI? L'articolo afferma che Cosmic CLI rispetta gli stessi limiti basati sul piano del dashboard, inclusi i limiti per gli AI Agents.

Alternative

• Integrazione API-driven (scrivi i tuoi script): Se preferisci il pieno controllo, puoi creare i tuoi script terminali intorno alle API di Cosmic per operazioni sui contenuti, automazione repository e deployment; questo scambia comodità per personalizzazione.
• Assistenti AI per coding generici nel tuo IDE: Gli assistenti per coding focalizzati sull'IDE aiutano con le modifiche al codice, ma potrebbero non coprire direttamente la strutturazione contenuti specifica di Cosmic, la preparazione repository e i workflow di deployment su Vercel.
• Tool di automazione workflow (piattaforme CI/CD e orchestrazione): Tool che orchestrano job e deployment possono automatizzare parti del workflow, ma richiedono passaggi aggiuntivi per generare contenuti strutturati Cosmic e coordinare interazioni con agenti.
• Gestione contenuti e app dashboard-first: Rimanere nel dashboard Cosmic è un'alternativa quando vuoi tooling visivo, anche se non fornisce la shell interattiva terminal-driven, l'automazione repo/deployment o i workflow agenti controllati da CLI descritti qui.