Aller au contenu principal

Vue d'ensemble de la CLI Copera

copera est l'interface en ligne de commande officielle de Copera. Utilisez-la pour travailler avec les boards, tables, lignes, docs, fichiers du drive, channels, notifications et données du workspace — directement depuis votre terminal, un script ou un agent de code IA.

La CLI s'adresse à deux publics :

  • Utilisateurs avancés qui préfèrent le clavier à l'interface, veulent automatiser des tâches répétitives ou lancer Copera depuis un shell distant.
  • Agents de code IA (Claude Code, Cursor, Codex et autres) qui exécutent des actions réelles et auditables dans votre workspace en votre nom.

Chaque action s'exécute en tant que l'utilisateur lié au token — vos permissions sont respectées, et chaque modification est entièrement réversible dans l'application.

info

La CLI encapsule la Copera Public API. Son URL de base est https://api.copera.ai/public/v1. Si vous préférez appeler l'API directement, ou connecter un client IA via MCP, consultez la Vue d'ensemble MCP.

Installation​

macOS / Linux​

Exécutez ceci dans votre terminal :

curl -fsSL https://cli.copera.ai/install.sh | bash

Par défaut, l'installateur écrit le binaire copera dans /usr/local/bin/copera. Si ce répertoire exige des permissions élevées, le script demande sudo.

Pour installer une version précise :

VERSION=0.1.0 curl -fsSL https://cli.copera.ai/install.sh | bash

Windows​

Ouvrez PowerShell et exécutez :

irm https://cli.copera.ai/install.ps1 | iex

Vous n'avez pas besoin d'exécuter PowerShell en tant qu'administrateur — cela installe copera.exe dans votre profil utilisateur. Fermez puis rouvrez PowerShell, puis vérifiez :

copera version

Pour figer une version précise :

$env:VERSION = "0.1.0"; irm https://cli.copera.ai/install.ps1 | iex

Si vous préférez installer manuellement : téléchargez le zip Windows AMD64 de la version souhaitée depuis le CDN de la CLI Copera, extrayez copera.exe, placez-le dans un répertoire de votre PATH (par exemple %LOCALAPPDATA%\Microsoft\WindowsApps), puis ouvrez une nouvelle fenêtre PowerShell et lancez copera version.

Depuis les sources​

Si Go est installé :

go install github.com/copera/copera-cli/cmd/copera@latest

Mise à jour​

Mettez à jour une installation existante à tout moment :

copera update                  # met à jour vers la dernière version
copera update --version 1.2.0  # fige une version précise
copera update --force          # saute l'invite de confirmation

Démarrage rapide​

Connectez-vous. Le flux le plus simple ouvre un navigateur et affiche une URL utilisable partout :

copera auth login

La CLI affiche une URL Copera, l'ouvre dans votre navigateur par défaut lorsque c'est possible, et vous demande de coller le token généré dans le terminal. L'URL affichée est toujours disponible, donc le même flux fonctionne en SSH, sous WSL, ou dans tout terminal où le navigateur pourrait ne pas s'ouvrir automatiquement.

Si vous avez déjà un token, sautez le navigateur :

copera auth login --token=cp_pat_xxx

Pour le CI, les scripts et les pipelines d'agents, une variable d'environnement est la solution la plus propre :

export COPERA_CLI_AUTH_TOKEN="cp_pat_xxx"

Confirmez la session :

copera auth status     # profil actif + origine du token
copera auth whoami     # à qui appartient le token

Essayez quelques commandes :

copera boards list
copera docs tree
copera search "onboarding"

Pour une sortie lisible par machine, ajoutez --json :

copera boards list --json

Voir Authentification pour les types de tokens et les flux de connexion, et Commandes pour la référence complète des commandes.

Formats de sortie​

La CLI est conçue pour bien fonctionner aussi bien dans les terminaux interactifs que dans les pipelines automatisés.

  • Lorsque stdout est un TTY, la sortie est un tableau coloré, lisible par un humain.
  • Lorsque stdout n'est pas un TTY (pipé vers une autre commande, redirigé vers un fichier, ou exécuté en CI), la sortie bascule par défaut en JSON — sûr pour les agents par défaut.
  • --json force la sortie JSON même dans un terminal.
  • --output accepte auto (défaut), json, table ou plain.
  • --quiet / -q supprime les messages informatifs.
  • --no-input (et CI=true) désactivent les invites interactives.
copera boards list                 # tableau dans un terminal, JSON si pipé
copera boards list --json | jq '.[].name'
copera boards list --output plain  # une valeur par ligne, pour les scripts

Les erreurs sont émises sur stderr en JSON structuré, afin que la sortie de succès reste propre :

{"error":"resource_not_found","message":"Board 'abc123' not found","suggestion":"Run 'copera boards list' to see accessible boards","transient":false}

transient: true signifie que l'erreur est réessayable ; false signifie qu'un nouvel essai n'aidera pas.

Codes de sortie​

Les codes de sortie sont stables, afin que les scripts puissent s'y appuyer en toute sécurité :

CodeSignification
0OK
1Erreur générique
2Erreur d'utilisation (flags incorrects, arguments manquants)
3Introuvable
4Erreur d'auth / permission refusée
5Conflit (p. ex. une ressource qui existe déjà)
6Limite de débit atteinte

Variables d'environnement​

VariableDescription
COPERA_CLI_AUTH_TOKENToken d'API. Remplace tous les fichiers de configuration.
COPERA_PROFILENom du profil de configuration actif (défaut : default).
COPERA_SANDBOXDéfinir à 1 pour cibler l'API de développement (api-dev.copera.ai).
COPERA_NO_UPDATE_CHECKDéfinir à 1 pour désactiver les vérifications de version en arrière-plan.
CIDéfinir à true pour désactiver les invites interactives et les vérifications de mise à jour.
NO_COLORDésactive la sortie couleur ANSI.

Voir Configuration pour la liste complète, y compris les profils et les options des fichiers de configuration.

Explorer la documentation​

Authentification

Types de tokens, flux de connexion, et comment la CLI résout les identifiants.

Commandes

La référence complète des commandes — boards, lignes, docs, drive, channels, et plus.

Configuration

Profils, IDs par défaut, variables d'environnement et sortie lisible par machine.

Serveur MCP

Connectez des clients IA à la même Public API via le Model Context Protocol.

Articles associés​