> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI tools

> Exécuter des outils en ligne de commande dans le sandbox Happycapy.

## Aperçu

Une interface en ligne de commande, ou CLI, est un outil que l'on exécute avec des commandes plutôt qu'avec des boutons. Beaucoup de services fournissent des CLI pour gérer des dépôts, documents, déploiements, logs et données de workspace de façon programmable.

Dans Happycapy, vous n'avez pas besoin de mémoriser ces commandes. Décrivez ce que vous voulez faire en langage naturel, et Happycapy peut installer le CLI, choisir les bonnes commandes, les exécuter dans le sandbox, lire la sortie et continuer le travail dans le même Project.

Un CLI peut se connecter à un service externe comme GitHub, Notion, Lark ou Fly.io. Il peut aussi être un utilitaire local pour travailler avec des fichiers, du code, des médias ou des données dans le sandbox.

## Quand utiliser les CLI tools

Utilisez les CLI tools lorsqu'un service expose des actions utiles sous forme de commandes :

* Travailler avec des dépôts, pull requests, issues, logs et déploiements
* Lire ou mettre à jour des systèmes de workspace comme Notion et Lark
* Exécuter des commandes cloud, base de données ou infrastructure
* Transformer un travail en ligne de commande répétable en Project workflow

## CLI ou MCP ?

CLI et MCP peuvent sembler très proches dans Happycapy : vous décrivez l'objectif en langage naturel, et l'agent décide quels outils appeler ou quelles commandes écrire.

La différence se situe surtout dans la couche de connexion. Avec les CLI tools, Happycapy écrit et exécute des programmes en ligne de commande dans le sandbox. Avec [MCP](/fr/integrations/mcp), Happycapy appelle des outils exposés par un serveur MCP.

Si un service dispose d'un CLI officiel bien maintenu, ou si la tâche concerne des déploiements, logs, scripts, fichiers ou une configuration ponctuelle, le CLI est souvent le chemin le plus direct. Si un service dispose d'un serveur MCP maintenu, ou si vous voulez exposer des actions d'outils via une interface structurée, MCP peut mieux convenir. Si les deux existent, choisissez l'option officielle, claire sur les permissions et la plus simple à configurer.

## Avant de commencer

Contexte utile à fournir :

* Le nom officiel du CLI ou son lien d'installation
* Le compte, workspace, dépôt ou app à connecter
* Le mode d'authentification requis, comme un login, token, API key ou une permission workspace
* Le résultat que vous voulez que Happycapy accomplisse après la configuration

## Première utilisation

Donnez à Happycapy l'outil et l'objectif :

```text theme={null}
Installe [CLI name] dans le sandbox Happycapy.
Avant de continuer, indique-moi quelle authentification est requise.
Une fois prêt, utilise-le pour [goal].

Lien CLI : [official link]
```

## CLI recommandées

Ces CLI fonctionnent bien dans un sandbox Happycapy parce qu'elles exposent de vrais systèmes de travail sous forme de commandes qu'un agent peut installer, configurer et exécuter.

<CardGroup cols={2}>
  <Card title="GitHub CLI" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/github.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=679bb093797d36e654af372f853a460a" href="https://cli.github.com" width="560" height="560" data-path="images/integrations/logos/github.png">
    Travailler avec des dépôts, pull requests, issues et GitHub Actions.
  </Card>

  <Card title="ntn" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/notion.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=534c589e6711180fe51fa3b632720e51" href="https://developers.notion.com/cli" width="64" height="64" data-path="images/integrations/logos/notion.png">
    Rechercher des pages Notion, créer du contenu et interroger des bases de données.
  </Card>

  <Card title="lark-cli" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/lark.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=adc21fbe2f882fafdd5006135fb05128" href="https://github.com/larksuite/cli" width="48" height="48" data-path="images/integrations/logos/lark.png">
    Travailler avec les messages, docs, feuilles, calendriers, tâches, mails et réunions Lark/Feishu.
  </Card>

  <Card title="flyctl" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/flyio.svg?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=d9342a993c06f2170919e5f5a526a3d3" href="https://fly.io/docs/flyctl/" width="167" height="151" data-path="images/integrations/logos/flyio.svg">
    Déployer et exploiter des apps Fly.io, Machines, logs, secrets et releases.
  </Card>
</CardGroup>

## Exemples de workflows

```text theme={null}
Utilise GitHub CLI.
Analyse le dernier GitHub Actions run échoué pour ce dépôt.
Résume l'erreur et propose la correction la plus simple.
```

```text theme={null}
Utilise ntn.
Recherche les documents d'onboarding dans notre Notion workspace.
Résume le processus actuel et liste les manques.
```

```text theme={null}
Utilise lark-cli.
Récupère les mises à jour projet de cette semaine dans Lark docs.
Transforme-les en court rapport d'équipe.
```

```text theme={null}
Utilise flyctl.
Vérifie le statut et les logs récents de cette app Fly.io.
Dis-moi si le dernier deploy est sain.
```

## Authentification et permissions

* Commencez par le compte, workspace, dépôt ou project que le CLI doit connecter.
* Évitez de mettre des secrets dans les prompts lorsque c'est possible. Préférez le flux d'authentification normal du CLI.
* Demandez à Happycapy d'expliquer les permissions requises avant d'approuver l'authentification.
* Pour les tokens, préférez des tokens limités ou de courte durée lorsque le service le permet.
* Pour les opérations destructives, demandez à Happycapy d'afficher la commande et l'effet attendu avant de l'exécuter.

## Dépannage

### Le CLI ne s'installe pas

Partagez le lien d'installation officiel et demandez à Happycapy de vérifier l'environnement sandbox, le gestionnaire de paquets et les exigences de plateforme.

### La connexion échoue

Confirmez si le CLI attend une connexion navigateur, un token, une validation workspace ou des variables d'environnement.

### Permission denied

Demandez à Happycapy d'indiquer quelle permission manque et si l'action nécessite un autre token, rôle, workspace, dépôt ou organisation.

### La sortie est trop large

Réduisez la demande avec un dépôt, project, intervalle de dates, chemin de fichier, nom d'app ou cible de commande.

## Étapes suivantes

* Consultez [MCP](/fr/integrations/mcp) pour découvrir une autre façon de connecter des outils. MCP ressemble à CLI côté usage, mais appelle des outils depuis un serveur MCP au lieu d'exécuter des programmes en ligne de commande dans le sandbox.
* Utilisez [Automations](/fr/features/automations) lorsque le même CLI workflow doit s'exécuter selon un planning.