Übersicht der Copera CLI
copera ist die offizielle Kommandozeilenschnittstelle für Copera. Damit arbeiten Sie mit Boards, Tabellen, Zeilen, Docs, Drive-Dateien, Channels, Benachrichtigungen und Workspace-Daten — direkt im Terminal, in einem Skript oder über einen KI-Coding-Agenten.
Die CLI richtet sich an zwei Zielgruppen:
- Power-User, die die Tastatur der Oberfläche vorziehen, wiederkehrende Arbeit automatisieren oder Copera aus einer Remote-Shell nutzen wollen.
- KI-Coding-Agenten (Claude Code, Cursor, Codex und andere), die in Ihrem Namen echte, nachvollziehbare Aktionen im Workspace ausführen.
Jede Aktion läuft als der Benutzer hinter dem Token — Ihre Berechtigungen werden eingehalten, und jede Änderung ist in der App vollständig rückgängig machbar.
Die CLI kapselt die Copera Public API. Die Basis-URL ist https://api.copera.ai/public/v1. Wenn Sie die API lieber direkt ansprechen oder einen KI-Client über MCP anbinden möchten, siehe MCP-Übersicht.
Installation
macOS / Linux
Führen Sie dies im Terminal aus:
curl -fsSL https://cli.copera.ai/install.sh | bash
Standardmäßig schreibt der Installer die Binary copera nach /usr/local/bin/copera. Wenn für dieses Verzeichnis erhöhte Rechte nötig sind, fragt das Skript nach sudo.
Eine bestimmte Version installieren:
VERSION=0.1.0 curl -fsSL https://cli.copera.ai/install.sh | bash
Windows
Öffnen Sie PowerShell und führen Sie aus:
irm https://cli.copera.ai/install.ps1 | iex
Sie müssen PowerShell nicht als Administrator starten — das installiert copera.exe in Ihr Benutzerprofil. Schließen und öffnen Sie PowerShell neu und prüfen Sie:
copera version
Eine bestimmte Version festlegen:
$env:VERSION = "0.1.0"; irm https://cli.copera.ai/install.ps1 | iex
Für die manuelle Installation: Laden Sie das Windows-AMD64-Zip der gewünschten Version vom Copera-CLI-CDN herunter, entpacken Sie copera.exe, legen Sie es in ein Verzeichnis auf Ihrem PATH (z. B. %LOCALAPPDATA%\Microsoft\WindowsApps) und führen Sie in einem neuen PowerShell-Fenster copera version aus.
Aus dem Quellcode
Wenn Go installiert ist:
go install github.com/copera/copera-cli/cmd/copera@latest
Aktualisieren
Eine bestehende Installation jederzeit aktualisieren:
copera update # update to the latest version
copera update --version 1.2.0 # pin to a specific version
copera update --force # skip the confirmation prompt
Schnellstart
Anmelden. Der einfachste Ablauf öffnet einen Browser und gibt eine URL aus, die Sie überall verwenden können:
copera auth login
Die CLI gibt eine Copera-URL aus, öffnet sie nach Möglichkeit im Standardbrowser und fordert Sie auf, das erzeugte Token zurück ins Terminal einzufügen. Die ausgegebene URL ist immer verfügbar — derselbe Ablauf funktioniert über SSH, in WSL oder in jedem Terminal, in dem der Browser nicht automatisch öffnet.
Wenn Sie bereits ein Token haben, können Sie den Browser überspringen:
copera auth login --token=cp_pat_xxx
Für CI, Skripte und Agenten-Pipelines ist eine Umgebungsvariable am saubersten:
export COPERA_CLI_AUTH_TOKEN="cp_pat_xxx"
Sitzung bestätigen:
copera auth status # active profile + where the token came from
copera auth whoami # who the token belongs to
Einige Befehle ausprobieren:
copera boards list
copera docs tree
copera search "onboarding"
Für maschinenlesbare Ausgabe --json ergänzen:
copera boards list --json
Siehe Authentifizierung für Token-Typen und Login-Abläufe sowie Befehle für die vollständige Befehlsreferenz.
Unter Ein Design in Claude Code oder Codex weiterbearbeiten erfahren Sie, wie Sie ein Design lokal bearbeiten und Ihre Änderungen in Copera speichern.
Ausgabeformate
Die CLI ist sowohl für interaktive Terminals als auch für automatisierte Pipelines ausgelegt.
- Wenn stdout ein TTY ist, erscheint die Ausgabe als farbige, lesbare Tabelle.
- Wenn stdout kein TTY ist (an einen anderen Befehl weitergeleitet, in eine Datei umgeleitet oder in CI), ist die Standardausgabe JSON — standardmäßig agentensicher.
--jsonerzwingt JSON-Ausgabe auch im Terminal.--outputakzeptiertauto(Standard),json,tableoderplain.--quiet/-qunterdrückt Info-Meldungen.--no-input(undCI=true) deaktiviert interaktive Prompts.
copera boards list # table in a terminal, JSON when piped
copera boards list --json | jq '.[].name'
copera boards list --output plain # one value per line, for scripts
Fehler werden auf stderr als strukturiertes JSON ausgegeben, damit die Erfolgsausgabe sauber bleibt:
{"error":"resource_not_found","message":"Board 'abc123' not found","suggestion":"Run 'copera boards list' to see accessible boards","transient":false}
transient: true bedeutet, dass der Fehler erneut versuchbar ist; false bedeutet, dass erneutes Versuchen nicht hilft.
Exit-Codes
Exit-Codes sind stabil, damit Skripte sicher darauf verzweigen können:
| Code | Bedeutung |
|---|---|
0 | OK |
1 | Allgemeiner Fehler |
2 | Nutzungsfehler (falsche Flags, fehlende Argumente) |
3 | Nicht gefunden |
4 | Auth-Fehler / keine Berechtigung |
5 | Konflikt (z. B. Ressource existiert bereits) |
6 | Rate-Limit erreicht |
Umgebungsvariablen
| Variable | Beschreibung |
|---|---|
COPERA_CLI_AUTH_TOKEN | API-Token. Überschreibt jede Konfigurationsdatei. |
COPERA_PROFILE | Name des aktiven Konfigurationsprofils (Standard: default). |
COPERA_SANDBOX | Auf 1 setzen, um die Entwicklungs-API (api-dev.copera.ai) anzusprechen. |
COPERA_NO_UPDATE_CHECK | Auf 1 setzen, um Hintergrund-Versionsprüfungen zu deaktivieren. |
CI | Auf true setzen, um interaktive Prompts und Update-Prüfungen zu deaktivieren. |
NO_COLOR | ANSI-Farbausgabe deaktivieren. |
Siehe Konfiguration für die vollständige Liste inklusive Profile und Optionen der Konfigurationsdatei.
Dokumentation erkunden
Token-Typen, Login-Abläufe und wie die CLI Anmeldedaten auflöst.
Die vollständige Befehlsreferenz — Boards, Zeilen, Docs, Drive, Channels und mehr.
Profile, Standard-IDs, Umgebungsvariablen und maschinenlesbare Ausgabe.
KI-Clients über das Model Context Protocol mit derselben Public API verbinden.
Verwandte Themen
- Erste Schritte mit der API — die REST-Oberfläche, die die CLI kapselt.
- API-Authentifizierung — Token-Scopes und Berechtigungen im Detail.
- Public-API-Referenz — alle Endpunkte und Schemas.