Cosmic CLI

Was ist Cosmic CLI?

Cosmic CLI ist eine AI-gestützte Kommandozeilenoberfläche, die Cosmic-Plattform-Funktionen in einen Terminal-Workflow bringt. Sie hilft dabei, Anwendungen zu bauen, Inhalte zu verwalten, in die Produktion zu deployen und AI-Agents auszuführen oder zu orchestrieren – ohne den Command Line zu verlassen.

Statt sich nur auf das Cosmic-Dashboard zu verlassen, bietet die CLI interaktive und AI-unterstützte Command-Modi für mehrstufige Aufgaben – wie die Generierung einer produktionsreifen App mit Repository-Setup und Deployment – über natürliche Sprachbefehle und strukturierte Workflows.

Wichtige Features

• Ein-Befehl-Installation und globaler CLI-Einsatz: CLI global installieren (mit npm oder bun), um Cosmic-Funktionen direkt im Terminal auszuführen.
• Interaktive Shell mit Workspace-Navigation: Interaktive Session starten mit Befehlshistorie, workspace-bewussten Prompts, Dateisystem-ähnlicher Navigation und Ausführung von Systembefehlen mit konfigurierbarem Prefix.
• AI-Chat-Modi mit Content-Kontext: Konversationelle Modi mit vollständiger Kontextkenntnis deiner Inhalte, Flags für zusätzlichen Kontext bei AI-Operationen.
• App-Generierung per Natursprache mit Repo-Setup: Beschreibe, was du bauen möchtest; die CLI erzeugt eine produktionsreife App, verbunden mit deinem Cosmic-Projekt, und bereitet ein GitHub-Repository für den Deployment vor.
• AI-gestützte Code-Updates aus deinem Repository: Bestehendes Repository verbinden, damit ein Code Agent den Code analysiert, einen Feature-Branch erstellt und Änderungen basierend auf deinen Anweisungen committet.
• Vercel-Deployment-Automatisierung: Direkt zu Vercel deployen mit Environment-Variable-Management, Custom-Domain-Handling, Preview-Deployments, Produktions-Releases und Echtzeit-Log-Streaming.
• CLI-Steuerung für AI-Agents und Workflows: Drei Agent-Typen vom Terminal aus erstellen, ausführen und verwalten, inklusive Erfassung von Browser-Auth-Sessions für Computer-Use-Agents, Freigabe wartender Operationen und Verknüpfung zu AI-Workflows mit schrittweiser Überwachung.
• Repository- und Environment-Variable-Management: GitHub-Repos, Branches, Pull Requests, Environment-Variablen und Custom Domains verwalten, mit automatischer Konfiguration lokaler Settings inklusive korrekter Cosmic-API-Keys (auch Next.js-spezifische Varianten).
• Mehrere AI-Model-Provider: Aus mehreren AI-Providern wählen und Default-Model setzen (Beispiele: Claude via Anthropic, GPT via OpenAI, Gemini via Google).

Cosmic CLI nutzen

1. CLI global installieren mit deiner bevorzugten Methode (Artikel erwähnt npm und bun).
2. Authentifizieren mit einer der zwei unterstützten Methoden: User-Auth für vollen Dashboard-Zugang oder Bucket-Key-Auth für schnellen Zugriff auf einen spezifischen Bucket.
3. Interaktive Session starten oder direkte Befehle für Arbeit in deinem Cosmic-Workspace nutzen.
4. Projekte erstellen oder aktualisieren per Natursprachbefehlen für App-Generierung oder durch Verbindung zu einem bestehenden Git-Repository für AI-unterstützte Code-Änderungen.
5. Zu Vercel deployen direkt aus der CLI, inklusive Preview-Deployments und Produktions-Releases, mit vom CLI gehandhabter Environment- und Domain-Konfiguration.
6. AI-Agents und Workflows ausführen vom Terminal, mit Überwachung des Fortschritts und Freigabe notwendiger wartender Operationen.

Anwendungsfälle

• Von der Idee zur Live-App (inkl. Content und Deployment): Produktreife App zu deinem Cosmic-Projekt generieren, mit GitHub-Repository und live Vercel-Deployment in einem einzigen End-to-End-Flow.
• Content-Operationen warten und skalieren: AI-gestützte Content-Erstellung für korrekt strukturierte Objekte in deinem Cosmic-Bucket nutzen und interaktiven Content-Chat-Modus für laufende Aufgaben.
• Bestehenden Codebase mit review-fähigen Änderungen modifizieren: CLI auf Repository zeigen, damit Code Agent Feature-Branch und Commits basierend auf Anweisungen erstellt, Pull Request öffnet und Preview deployt.
• Environment-Konfiguration aktualisieren und zuverlässig deployen: CLI für Environment-Variablen und Custom Domains bei Deployments nutzen, mit Log-Streaming zur Fortschrittsverfolgung.
• Mehrstufige AI-Aufgaben vom Terminal koordinieren: Unterstützte Agent-Typen ausführen und zu AI-Workflows verknüpfen, Fortschritt pro Schritt prüfen und Runs bei Bedarf abbrechen.

FAQ

• Erfordert Cosmic CLI die Nutzung des Cosmic Dashboards? Nein. Die CLI bringt Cosmic-Funktionen direkt in Ihr Terminal, inklusive Content-Management, App-Erstellung, Deployment und Agent-Orchestrierung.

• Wie handhabt die CLI die Authentifizierung? Die CLI unterstützt zwei Methoden: Benutzer-Authentifizierung (voller Dashboard-Zugang) und Bucket-Key-Authentifizierung (schneller Zugriff auf einen spezifischen Bucket ohne Login).

• Welche AI-Interaktionen sind über die CLI verfügbar? Die CLI bietet AI-Chat-Modi mit Content-Kontext und unterstützt AI-Agents sowie AI-Workflows, die vom Terminal aus gesteuert werden können.

• Kann die CLI zu Vercel deployen? Ja. Die CLI enthält integrierte Vercel-Unterstützung für Environment-Variable-Management, Preview-Deployments, Produktions-Releases, Custom Domains und Echtzeit-Log-Streaming.

• Gibt es planbasierte Limits für die CLI-Nutzung? Der Artikel besagt, dass Cosmic CLI dieselben planbasierten Limits wie das Dashboard einhält, inklusive Limits für AI-Agents.

Alternativen

• API-gestützte Integration (eigene Skripte schreiben): Bei Vorliebe für volle Kontrolle können Sie eigene Terminal-Skripte um Cosmic-APIs für Content-Operationen, Repository-Automatisierung und Deployments bauen; dies tauscht Bequemlichkeit gegen Anpassbarkeit.
• Allgemeine AI-Coding-Assistenten in der IDE: IDE-fokussierte Coding-Assistenten helfen bei Code-Änderungen, decken aber Cosmic-spezifische Content-Strukturierung, Repository-Vorbereitung und Vercel-Deployment-Workflows möglicherweise nicht direkt ab.
• Workflow-Automatisierungs-Tools (CI/CD- und Orchestrierungsplattformen): Tools zur Orchestrierung von Jobs und Deployments automatisieren Teile des Workflows, erfordern aber zusätzliche Schritte für strukturierte Cosmic-Contents und Agent-Interaktionen.
• Dashboard-basierte Content- und App-Verwaltung: Bleiben Sie im Cosmic Dashboard für visuelle Tools – es bietet jedoch nicht die terminalgesteuerte interaktive Shell, Repo-/Deployment-Automatisierung oder CLI-gesteuerten Agent-Workflows wie hier beschrieben.