Passer au contenu principal
Le CLI Faces vous permet de générer des présentations interactives et explorables depuis votre terminal. Décrivez ce que vous voulez et obtenez un projet partageable et en direct en quelques secondes.

Installation

Cela installe la commande faces dans votre $PATH.

Authentification

Exécutez la commande de connexion pour créer et enregistrer une clé API :
Cette commande va :
  1. Ouvrir votre navigateur pour vous connecter à Faces
  2. Créer une clé API nommée « CLI »
  3. L’enregistrer dans ~/.config/faces/credentials.json (mode 0600)
Par défaut, la clé est associée à votre équipe personnelle. Pour utiliser une équipe partagée à la place, passez --team avec le slug ou l’id de l’équipe :
Toute commande CLI exécutée avec cette clé fonctionnera sous l’équipe choisie. Les nouveaux projets y sont créés, et faces list affiche les projets de cette équipe (ainsi que ceux partagés avec vous). Vous pouvez trouver le slug ou l’id d’une équipe en exécutant faces teams list (ou via l’API : GET /api/v1/teams).
Vous pouvez aussi passer une clé API directement avec --api-key ou définir la variable d’environnement FACES_API_KEY. Les clés créées depuis Settings > Developers dans le tableau de bord vous permettent de choisir une équipe au moment de la création, comme alternative à faces login --team.

Vérification

Si l’authentification fonctionne, vous verrez vos projets (ou une liste vide).

Configuration

Le CLI lit la configuration dans cet ordre :
  1. Le flag --api-key (priorité la plus élevée)
  2. ~/.config/faces/credentials.json (créé par login)
  3. La variable d’environnement FACES_API_KEY