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.

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​

Authentifizierung

Token-Typen, Login-Abläufe und wie die CLI Anmeldedaten auflöst.

Befehle

Die vollständige Befehlsreferenz — Boards, Zeilen, Docs, Drive, Channels und mehr.

Konfiguration

Profile, Standard-IDs, Umgebungsvariablen und maschinenlesbare Ausgabe.

MCP-Server

KI-Clients über das Model Context Protocol mit derselben Public API verbinden.

Verwandte Themen​