CLI Référence des commandes
Exécuter champrep --help et champrep COMMAND --help pour connaître les options exactes fournies par la version installée. Cette page résume l’arborescence actuelle des commandes publiques.
Options globales
Section intitulée « Options globales »| Option | Objectif |
|---|---|
--env NAME | Remplacer l’environnement Gateway actif pour une seule commande. |
--profile ID | Utiliser un autre compte enregistré pour une commande sans modifier le compte actif. |
-v, --verbose | Enregistrer les métadonnées des requêtes et des réponses avec l’en-tête d’autorisation masqué. |
--debug | Ajouter les corps des requêtes et des réponses à la sortie de diagnostic. À utiliser avec prudence en présence de données sensibles. |
--json | Générer du JSON lisible par machine lorsque cela est pris en charge. |
--no-color | Désactiver les couleurs ANSI. Le respecte CLIégalement NO_COLOR. |
Placez les indicateurs persistants avant ou après une sous-commande, conformément aux règles acceptées par la version installée. Préférez --json pour l’automatisation.
Authentification
Section intitulée « Authentification »| Commande | Objectif |
|---|---|
champrep auth login | Se connecter via l’autorisation du navigateur. |
champrep auth login --no-browser | Imprimer une URL d’approbation pour un terminal distant. |
champrep auth token | Enregistrer une cléAPI à portée limitée dans le trousseau du système d’exploitation. |
champrep auth whoami | Afficher l’identité et le profil actifs. |
champrep auth status | Afficher l’identité, le quota en temps réel et le contexte d’audit disponible. |
champrep auth list | Répertorier les profils enregistrés dans tous les environnements. |
champrep auth switch PROFILE | Sélectionner un autre profil enregistré pour le même compte. |
champrep auth logout | Supprimer les informations d’identification locales actuelles et l’état du profil. |
| Commande | Objectif |
|---|---|
champrep drive ls [REMOTE_PATH] | Répertorier les fichiers d’un dossier. |
champrep drive tree [REMOTE_PATH] | Afficher une arborescence de dossiers récursive. |
champrep drive cp SOURCE DEST | Transférer un fichier entre l’ordinateur local et Drive. |
champrep drive mv OLD NEW | Déplacer ou renommer un élémentDrive. |
champrep drive rm REMOTE_PATH | Supprimer un fichier ou un dossier. |
champrep drive mkdir REMOTE_PATH | Créer un dossier. |
champrep drive quota | Afficher l’espace de stockage utilisé et disponible. |
Exemples :
champrep drive ls /champrep drive tree /projectschamprep drive cp ./report.pdf /reports/report.pdfchamprep drive cp /reports/report.pdf ./report.pdfchamprep drive quota --json| Commande | Objectif |
|---|---|
champrep mail ls | Répertorier les messages d’un dossier de boîte aux lettres. |
champrep mail read MESSAGE_ID | Imprimer un message. |
champrep mail send | Envoyez un message. --subject est obligatoire ; pour envoyer sans ce fichier, omettez-le et passez --no-subject. |
champrep mail accounts | Répertorier les boîtes aux lettres connectées. |
champrep mail threads | Répertorier les fils de discussion. |
champrep mail domains | Répertorier les domaines de messagerie visibles. |
Utiliser champrep mail send --help avant de créer un script d’envoi afin que les indicateurs relatifs au destinataire, à l’objet, au corps du message et aux pièces jointes de la version installée soient gérés correctement.
| Commande | Objectif |
|---|---|
champrep chat ls | Afficher la liste des salles. |
champrep chat read ROOM_ID | Lire les messages récents. |
champrep chat send ROOM_ID | Envoyer un message à la salle. |
champrep chat unread | Afficher le nombre de messages non lus. |
champrep chat create | Créer une salle. |
Contacts
Section intitulée « Contacts »| Commande | Objectif |
|---|---|
champrep contacts ls | Afficher la liste des contacts. |
champrep contacts search QUERY | Effectuer une recherche par e-mail ou par nom. |
champrep contacts read CONTACT_ID | Afficher un contact. |
champrep contacts labels | Afficher la liste des étiquettes. |
champrep contacts add USER_ID | Ajouter un utilisateur à vos contacts. |
champrep contacts update CONTACT_ID | Mettre à jour les métadonnées d’un contact. |
champrep contacts rm CONTACT_ID | Supprimer un contact. |
courses Accepte également le learn alias.
| Commande | Objectif |
|---|---|
champrep courses ls | Afficher la liste des cours disponibles. |
champrep courses enrolled | Répertorier les inscriptions de l’utilisateur actif. |
champrep courses read COURSE_ID | Afficher un cours. |
champrep courses sections COURSE_ID | Afficher la liste des sections de cours. |
| Commande | Objectif |
|---|---|
champrep notes ls | Afficher la liste des notes récentes. |
champrep notes create | Créer une note. |
champrep notes read NOTE_ID | Imprimer une note. |
champrep notes edit NOTE_ID | Mettre à jour le titre et/ou le corps d’une note. |
champrep notes rm NOTE_ID | Déplacez une note vers la Corbeille. Récupérez-la dans CHAMPREP Notes dans un délai de 30 jours ; passé ce délai, elle sera automatiquement supprimée. Une note placée dans la Corbeille peut être lue mais ne peut pas être modifiée. |
CHAMPREP AI (Eve)
Section intitulée « CHAMPREP AI (Eve) »| Commande | Objectif |
|---|---|
eve ou champrep ai | Lancez l’agent d’IA interactif de programmation en binôme Eve dans le répertoire courant. |
champrep eve | Alias pour champrep ai / eve. |
eve -p PROMPT ou champrep ai -p PROMPT | Exécutez l’agent en mode sans interface pour une invite et affichez la réponse. |
champrep ai models ls | Répertorier les modèles de la plateforme et les modèles que vous avez enregistrés avec votre propre clé. |
champrep ai models register | Enregistrez un modèle utilisant votre propre cléAPI de fournisseur. |
champrep ai models rm NAME | Supprimer un modèle enregistré et sa clé. |
champrep ai paths | Afficher tous les fichiers et dossiers locaux utilisés par l’agent. |
champrep ai chat [PROMPT] | Poser une question ponctuelle ou lancer une session interactive. |
champrep ai summarize | Résumer un fichier. |
champrep ai conversations | Afficher la liste des conversations enregistrées. |
champrep ai read CONVERSATION_ID | Lire une conversation. |
champrep ai rm CONVERSATION_ID | Supprimer une conversation. |
champrep ai usage | Afficher l’utilisation actuelle de l’IA. |
Vérifier les résultats importants générés par l’IA avant de s’y fier.
Pour les commandes « / », les autorisations et les options de l’agent, consultez Agent IA : Eve (champrep ai / eve).
| Commande | Objectif |
|---|---|
champrep meet create | Créer une salle de réunion. |
champrep meet ls | Répertorier les réunions. |
champrep meet join MEETING_ID | Ouvrir une réunion dans le navigateur par défaut. |
Calendar
Section intitulée « Calendar »calendar Accepte également le cal alias.
| Commande | Objectif |
|---|---|
champrep calendar today | Afficher les événements du jour. |
champrep calendar week | Afficher les événements de cette semaine. |
champrep calendar create | Créer un événement. |
champrep calendar rm EVENT_ID | Supprimer un événement. |
Recherche
Section intitulée « Recherche »Recherchez tout ce à quoi vos identifiants donnent accès en une seule requête. Les résultats sont regroupés par service, et tout élément ignoré est répertorié avec la raison correspondante.
| Commande | Objectif |
|---|---|
champrep search QUERY | Effectuez une recherche sur l’ensemble de vos services. |
champrep search services | Affichez la liste des services que vous pouvez interroger et indiquez si la recherche IA est disponible. |
| Option | Objectif |
|---|---|
-s, --service | Limiter à un service (répétable). Permet de réduire le coût de la requête. |
--limit | Nombre maximal de résultats par service (par défaut 5, max. 20). |
--ai | Classez les résultats à l’aide de l’IA et obtenez une réponse concise. Utilise vos propres crédits IA. |
champrep search "q3 roadmap"champrep search "invoice 1042" --service invoice --service mailchamprep search "what did we decide about pricing" --aiUne recherche coûte une unité de limite de débit par service effectivement interrogé ; par conséquent, affiner la recherche avec --service est le moyen le plus économique de garantir la réactivité du système. --ai utilise vos crédits IA mensuels ; sans crédits, la commande renvoie tout de même des résultats normaux et vous explique pourquoi le classement par IA n’a pas pu être effectué.
| Commande | Objectif |
|---|---|
champrep work boards | Répertorier vos tableaux. |
champrep work board BOARD_ID | Afficher un tableau de bord. |
champrep work tickets | Liste des tickets. Filtrer par --board, --status (un identifiant de statut, ou avec --board un nom de statut), --search, --mine; --limit 1 à 200. |
champrep work ticket TICKET | Afficher un ticket par identifiant ou par clé (par exemple ENG-7). |
champrep work create | Créer un ticket (--board, --title, --priority, --type). |
champrep work tickets --minechamprep work create --board 642f... --title "Fix login" --priority high --type bug| Commande | Objectif |
|---|---|
champrep invoice ls | Répertorier les factures. Filtrer par --status. |
champrep invoice read INVOICE_ID | Afficher une facture. |
champrep invoice issue INVOICE_ID | Émettre un brouillon (passer du statut « brouillon » à « émis »). |
champrep invoice send INVOICE_ID | Envoyer une facture par e-mail (--to lorsqu’aucun destinataire n’est enregistré). |
champrep invoice rm INVOICE_ID | Supprimer un brouillon. |
La création et l’envoi de factures utilisent le quota d’envoi de factures de votre forfait ; ils nécessitent donc l’
invoice:send Autorisation sur une cléAPI.
| Commande | Objectif |
|---|---|
champrep forms ls | Répertorier vos formulaires. |
champrep forms read FORM_ID | Afficher un formulaire. |
champrep forms responses FORM_ID | Répertorier les réponses d’un formulaire. |
champrep forms create | Créer un formulaire (--title, --description, --publish). |
champrep forms publish FORM_ID | Publier un brouillon de formulaire. |
champrep forms rm FORM_ID | Déplacer un formulaire vers la corbeille. |
Organigramme
Section intitulée « Organigramme »| Commande | Objectif |
|---|---|
champrep charts me | Afficher votre poste dans l’organigramme. |
champrep charts tree | Imprimer l’organigramme au format JSON. |
champrep charts search QUERY | Rechercher des personnes au sein de l’organisation. |
champrep charts profile USER_ID | Imprimer le profil d’une personne au format JSON. |
Entreprise
Section intitulée « Entreprise »Gestion de l’organisation (entreprise). Les lectures utilisent le business:read scope.
| Commande | Objectif |
|---|---|
champrep business info | Afficher votre organisation et le rôle que vous y occupez. |
champrep business members | Répertorier les membres de l’organisation. |
champrep business usage | Afficher les statistiques d’utilisation de l’organisation. |
CHAMPREP Code
Section intitulée « CHAMPREP Code »Projets, branches, demandes de fusion, tickets, pipelines, journaux de tâches et versions.
PROJECT est le chemin d’accès complet du projet (acme/web) ou son identifiant. Référence complète :
CHAMPREP Commandes de code.
| Commande | Objectif |
|---|---|
champrep code projects ls / show / create | Répertorier, afficher et créer des projets. |
champrep code repo clone-url PROJECT | Afficher l’adresse du clone (--ssh (pour SSH). |
champrep code clone | Clonez des projets, un groupe (--group, --include-subgroups) ou entièrement le vôtre (--membership, --owned, --all) dans une arborescence d’espaces de noms ; --update permet de le maintenir à jour. |
champrep code branches ls PROJECT | Répertorier les branches. |
champrep code mr ls / show / create / merge / approve | Work avec les demandes de fusion. |
champrep code issues ls / show / create / close / reopen | Work présentant des problèmes. |
champrep code pipelines ls / show / run / retry / cancel | Work avec les pipelines. |
champrep code pipelines wait PROJECT [ID] | Attendez un pipeline, le plus récent d’un commit (--sha), ou la dernière version disponible sur --ref pour terminer ; quitte 0 En cas de réussite, 1 Sinon, 8 sur --timeout. |
champrep code jobs ls / log / play / retry | Répertorier les tâches, les imprimer ou les suivre (--follow) un journal, lancer des tâches manuelles. |
champrep code releases ls PROJECT | Répertorier les versions. |
champrep code runners ls / show / update / create | Répertoriez les runners et les utilisateurs en ligne, modifiez les balises, mettez en pause et reprenez l’exécution, créez un runner. |
champrep code ssh-keys ls | Répertoriez vos clés SSH pour git via SSH. |
champrep code clone --group acme --include-subgroups --dest ~/src --sshchamprep code mr ls acme/webchamprep code pipelines run acme/web --ref main --yeschamprep code jobs log acme/web 4182 --followLes recettes détaillées pour Code, Runner Farm et QA, y compris l’utilisation de l’intégration continue (CI), se trouvent dans Tâches courantes.
Ferme de runners
Section intitulée « Ferme de runners »runner-farm accepte également le rf alias. --workspace sélectionne le compte de la ferme (personal, organization:<id>, team:<id>). Référence complète :
Commandes de la ferme de runners.
| Commande | Objectif |
|---|---|
champrep rf accounts ls / show | Répertorier les comptes de la ferme sur lesquels vous pouvez effectuer des opérations ; en afficher un. |
champrep rf connections ls | Répertorier les connexions aux hôtes de code. |
champrep rf pools ls / show / create / update | Gérer les pools de runners, y compris --pause et --resume. |
champrep rf usage | Crédits et minutes pour la période en cours. |
champrep rf jobs ls | Répertorier les tâches, y compris celles en attente et celles mises en attente. |
champrep rf pools lschamprep rf usageCHAMPREP QA
Section intitulée « CHAMPREP QA »Référentiels, analyses, résultats, contrôles de qualité, aperçus et espaces de travail IDE.
REPO est une clé de référentiel telle que code:<project-uuid>. Référence complète :
CHAMPREP QA commandes.
| Commande | Objectif |
|---|---|
champrep qa repos ls / available / activate / deactivate / sync | Gérer les analyses d’assurance qualité des référentiels. |
champrep qa scan REPO | Lancer une analyse ; --watch La suit jusqu’à la fin. |
champrep qa scans ls / show | Répertorier et afficher les analyses. |
champrep qa findings ls / show / dismiss / reopen | Filtre (--severity, --cwe, --branch, --state) et trier les résultats. |
champrep qa gates status REPO | Affiche le résultat du contrôle de qualité ; quitte 1 en cas d’échec. |
champrep qa previews ls / show / create / extend / stop | Gérer les environnements de prévisualisation. |
champrep qa ide ls / start / open / stop | Gérer les espaces de travail de l’IDE cloud. |
champrep qa scan code:7d0c5c6e-0b6a-4e2b-9a55-0f8e6c1d2a10 --watch --yeschamprep qa findings ls --severity critical,highDans ces trois familles, les commandes qui modifient quelque chose ou utilisent des minutes d’intégration continue (CI), des crédits ou un quota demandent d’abord : code mr create, mr merge, mr approve,
issues close et reopen, chaque action de pipeline et de tâche, rf pools create
et update, et à chaque qa écriture (repos activate et deactivate, scan,
findings dismiss et reopen, previews create, extend et stop, ide start et stop). Passez --yes (-y) dans les scripts ; sans terminal et sans --yes, elles ne modifient rien. La création d’un projet ou d’un ticket Code ne vous demande pas de confirmation. --workspace sur rf et qa sélectionne le compte utilisé et facturé.
Compte et utilisation
Section intitulée « Compte et utilisation »| Commande | Objectif |
|---|---|
champrep account | Afficher votre identité, votre forfait, ainsi que votre limite de débit en temps réel, votre consommation quotidienne et votre utilisation de l’espace de stockage. |
champrep accountchamprep account --json
API clés
Section intitulée « API clés »Gérer le cpk_... Clés utilisées pour l’accès « headless » et l’accès CI. Ces commandes nécessitent une session de navigateur interactive (exécutez champrep auth login « first », et non
auth token). La création ou la rotation d’une clé affiche le secret une seule fois.
| Commande | Objectif |
|---|---|
champrep keys ls | Répertorier vos clésAPI. |
champrep keys create | Créer une clé (--name, répétable --scope, --expires-in-days, --allowed-ip). |
champrep keys get KEY_ID | Afficher les détails d’une clé. |
champrep keys audit KEY_ID | Afficher le journal d’audit récent d’une clé. |
champrep keys update KEY_ID | Modifier le nom, les champs d’application, la liste blanche d’adresses IP ou --active/--inactive. |
champrep keys regenerate KEY_ID | Remplacer le secret (l’ancien secret cesse de fonctionner). |
champrep keys revoke KEY_ID | Supprimer une clé. |
champrep keys create --name "CI deploy" --scope drive:read --scope drive:writechamprep keys create --name "read-only" --scope '*' --expires-in-days 90
Facturation
Section intitulée « Facturation »Affichage en lecture seule de votre abonnement. Modifier les formules dans le tableau de bord de facturation.
| Commande | Objectif |
|---|---|
champrep billing subscription | Afficher votre abonnement actuel (alias sub). |
champrep billing cards | Répertorier les moyens de paiement enregistrés. |
champrep billing receipts | Répertorier les reçus antérieurs. |
Webhooks
Section intitulée « Webhooks »Gérer les abonnements aux webhooks sortants. Utilise le webhooks:manage scope.
| Commande | Objectif |
|---|---|
champrep webhooks ls | Répertoriez vos webhooks. |
champrep webhooks events | Liste des types d’événements auxquels vous pouvez vous abonner. |
champrep webhooks create | Créez un webhook (--url, reproductible --event). Le secret de signature s’affiche une seule fois. |
champrep webhooks rotate WEBHOOK_ID | Effectuez une rotation du secret de signature. |
champrep webhooks rm WEBHOOK_ID | Supprimer un webhook. |
Configuration locale et outils
Section intitulée « Configuration locale et outils »Ces commandes ne nécessitent pas de demande de service, sauf indication contraire dans leur texte d’aide.
| Commande | Objectif |
|---|---|
champrep config get KEY | Lire une valeur de configuration. |
champrep config set KEY VALUE | Définissez une valeur de configuration autorisée. Un api_url ou web_url doit être un https:// adresse manquante. |
champrep config list | Imprimez la configuration actuelle. Avec --json les clés sont celles propres au fichier (default_environment, api_url …). |
champrep config path | Affichez le chemin d’accès au fichier de configuration. |
champrep config env [NAME] | Afficher ou définir l’environnement par défaut. |
champrep completion SHELL | Générez la complétion pour Bash, Zsh, Fish ou PowerShell. |
champrep version | Version d’impression, commit, date de compilation et informations d’exécution. |
Les jetons ne sont pas stockés dans le fichier de configuration. N’essayez pas d’écrire un jeton d’authentification avec config set.
Codes de sortie
Section intitulée « Codes de sortie »| Code | Signification |
|---|---|
0 | Succès. |
1 | Échec général ou lié à l’utilisation, ou refus que la reconnexion ne permet pas de résoudre : accès refusé à l’élément, non inclus dans votre forfait, paiement ou crédits requis, problème lié à votre rôle, ou décision nécessitant votre session Web. |
3 | L’authentification est requise ou n’est pas valide. |
4 | Les identifiants ne disposent pas de la portée requise. |
5 | Une limite en temps réel de la passerelle a été atteinte. |
6 | Panne réseau. |
7 | Défaillance de la passerelle ou du service. |
8 | Un délai d’attente a expiré : code pipelines wait --timeout. |
Les scripts doivent vérifier le code de sortie et analyser --json sortie lorsqu’elle est disponible. Ne considérez pas les messages d’erreur lisibles par l’utilisateur comme une interface stable.
Limites de débit
Section intitulée « Limites de débit »Chaque réponse de la passerelle indique vos limites actuelles. La effectue de manière transparenteCLI des tentatives de réessai en cas de limite minute courte, en respectant Retry-After. Elle non ne met pas en attente lorsqu’une limite journalière est atteinte ou en cas d’attente supérieure à quelques secondes — elle se termine plutôt avec un code 5 et signale la durée exacte de l’attente, afin que les scripts échouent rapidement. Vérifiez vos compteurs en temps réel à tout moment avec champrep account.