Die CometAPI CLI befindet sich in der Beta-Phase. Rechnen Sie mit kleineren Änderungen an Befehlen und UX, während sich die CLI-Oberfläche stabilisiert.
Funktionen
- Multi-Model-Chat mit Streaming und interaktivem REPL
- Modellsuche und -auflistung
- Kontostand und Nutzungsstatistiken
- Durchsuchen von Nutzungsprotokollen mit Filtern und CSV-Export
- Async-Task-Protokolle (Suno, Midjourney, Kling und andere)
- Ausgabe in mehreren Formaten: table, JSON, YAML, CSV, Markdown
- TOML-basierte Konfiguration mit Einrichtungsassistent
- Shell-Vervollständigung für Bash, Zsh und Fish
- Agentenfreundliches Design mit strukturiertem JSON-Output und deterministischen Exit-Codes
Voraussetzungen
- Python 3.10 oder höher
- Ein CometAPI API key
Installation
Verwenden Sie die PyPI-Paketseite als primäre Referenz für die Installation und wählen Sie dann eine der folgenden Methoden, um die CLI zu installieren:Schnellstart
Einrichtungsassistent ausführen
Der interaktive Assistent speichert Ihren API key und optionalen access token in einer lokalen Konfigurationsdatei:Der Assistent fragt nach:
- API key — für alle Befehle erforderlich. Erstellen Sie einen unter CometAPI Console → API Keys.
- Access token — optional, erforderlich für die Befehle
account,stats,tokens,logsundtasks. Erstellen Sie einen unter Console → Personal Settings.
Mit einem Modell chatten
Senden Sie eine einzelne Nachricht mit Streaming-Ausgabe:Überschreiben Sie das Standardmodell:
Ihren Kontostand prüfen
Zeigen Sie Ihren Kontostand an:Zeigen Sie die aktuelle Abrechnungsansicht des API key an:
Interaktive Chat-Sitzung
Führen Siecometapi chat ohne Argumente aus, um das Multi-Turn-Chat-REPL zu starten:
| Command | Beschreibung |
|---|---|
/model | Das aktive Modell wechseln |
/system | Den system prompt festlegen oder ändern |
/clear | Den Gesprächsverlauf löschen |
/history | Den Gesprächsverlauf anzeigen |
/save | Das Gespräch in einer Datei speichern |
/tokens | Die token-Nutzung für die Sitzung anzeigen |
/help | Alle REPL-Befehle auflisten |
/exit | Das REPL beenden |
Agent-Integration
Die CLI ist für die Nutzung durch AI-Coding-Agenten und Automatisierungsskripte konzipiert:- Alle Datenbefehle unterstützen
--jsonfür strukturierten, maschinenlesbaren Output - Deterministische Exit-Codes:
0(Erfolg),64(Konfiguration fehlt),77(Authentifizierungsfehler),69(Dienst nicht verfügbar) - Fehler gehen an stderr, Daten an stdout
- Siehe die vollständige Befehlsreferenz für befehlsspezifische Optionen