Zum Hauptinhalt springen

Ü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.

info

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.
  • --json erzwingt JSON-Ausgabe auch im Terminal.
  • --output akzeptiert auto (Standard), json, table oder plain.
  • --quiet / -q unterdrückt Info-Meldungen.
  • --no-input (und CI=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:

CodeBedeutung
0OK
1Allgemeiner Fehler
2Nutzungsfehler (falsche Flags, fehlende Argumente)
3Nicht gefunden
4Auth-Fehler / keine Berechtigung
5Konflikt (z. B. Ressource existiert bereits)
6Rate-Limit erreicht

Umgebungsvariablen​

VariableBeschreibung
COPERA_CLI_AUTH_TOKENAPI-Token. Überschreibt jede Konfigurationsdatei.
COPERA_PROFILEName des aktiven Konfigurationsprofils (Standard: default).
COPERA_SANDBOXAuf 1 setzen, um die Entwicklungs-API (api-dev.copera.ai) anzusprechen.
COPERA_NO_UPDATE_CHECKAuf 1 setzen, um Hintergrund-Versionsprüfungen zu deaktivieren.
CIAuf true setzen, um interaktive Prompts und Update-Prüfungen zu deaktivieren.
NO_COLORANSI-Farbausgabe deaktivieren.

Siehe Konfiguration für die vollständige Liste inklusive Profile und Optionen der Konfigurationsdatei.

Dokumentation erkunden​

Verwandte Themen​