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

# Installation du CLI

> Installez et authentifiez le CLI Faces pour générer des présentations interactives depuis votre terminal.

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

```bash theme={null}
npm install -g @facesapp/cli
```

Cela installe la commande `faces` dans votre `$PATH`.

## Authentification

Exécutez la commande de connexion pour créer et enregistrer une clé API :

```bash theme={null}
faces login
```

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 :

```bash theme={null}
faces login --team acme
```

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`).

<Info>
  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`.
</Info>

## Vérification

```bash theme={null}
faces list
```

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`

```bash theme={null}
# Avec les variables d'environnement
export FACES_API_KEY="faces_your_key_here"
faces list

# Avec les flags
faces list --api-key faces_your_key_here

```