> ## 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.

# Instalación del CLI

> Instala y autentica el CLI de Faces para generar presentaciones interactivas desde tu terminal.

El CLI de Faces te permite generar presentaciones interactivas y explorables desde tu terminal. Describe lo que quieres y obtén un proyecto en vivo y listo para compartir en segundos.

## Instalar

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

Esto instala el comando `faces` en tu `$PATH`.

## Autenticar

Ejecuta el comando de login para crear y guardar una API key:

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

Esto va a:

1. Abrir tu navegador para iniciar sesión en Faces
2. Crear una API key llamada "CLI"
3. Guardarla en `~/.config/faces/credentials.json` (modo `0600`)

Por defecto, la key se asocia a tu **equipo personal**. Para usar un equipo compartido, pasa `--team` con el slug o id del equipo:

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

Cada comando del CLI ejecutado con esa key va a operar bajo el equipo seleccionado. Los nuevos proyectos se crean ahí, y `faces list` muestra los proyectos de ese equipo (más los que comparten contigo). Puedes encontrar el slug o id de un equipo ejecutando `faces teams list` (o mediante la API: `GET /api/v1/teams`).

<Info>
  También puedes pasar una API key directamente con `--api-key` o establecer la variable de entorno `FACES_API_KEY`. Las keys creadas desde **Settings > Developers** en el panel te permiten elegir un equipo al momento de la creación como alternativa a `faces login --team`.
</Info>

## Verificar

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

Si la autenticación funciona, vas a ver tus proyectos (o una lista vacía).

## Configuración

El CLI lee la configuración en este orden:

1. Flag `--api-key` (máxima prioridad)
2. `~/.config/faces/credentials.json` (creado por `login`)
3. Variable de entorno `FACES_API_KEY`

```bash theme={null}
# Usando variables de entorno
export FACES_API_KEY="faces_your_key_here"
faces list

# Usando flags
faces list --api-key faces_your_key_here

```