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

# CLI Installation

> Install and authenticate the Faces CLI to generate interactive decks from your terminal.

The Faces CLI lets you generate interactive, explorable decks from your terminal. Describe what you want and get a live, shareable project in seconds.

## Install

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

This installs the `faces` command on your `$PATH`.

## Authenticate

Run the login command to create and store an API key:

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

This will:

1. Open your browser to sign in to Faces
2. Create an API key named "CLI"
3. Save it to `~/.config/faces/credentials.json` (mode `0600`)

By default the key is scoped to your **personal team**. To use a shared team instead, pass `--team` with the team slug or id:

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

Every CLI command run with that key will operate under the chosen team: new projects are created there, and `faces list` shows projects from that team (plus any shared with you). You can find a team's slug or id by running `faces teams list` (or via the API: `GET /api/v1/teams`).

<Info>
  You can also pass an API key directly with `--api-key` or set the `FACES_API_KEY` environment variable. Keys created from **Settings > Developers** in the dashboard let you pick a team at creation time as an alternative to `faces login --team`.
</Info>

## Verify

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

If authentication is working, you'll see your projects (or an empty list).

## Configuration

The CLI reads configuration in this order:

1. `--api-key` flag (highest priority)
2. `~/.config/faces/credentials.json` (created by `login`)
3. `FACES_API_KEY` environment variable

```bash theme={null}
# Using environment variables
export FACES_API_KEY="faces_your_key_here"
faces list

# Using flags
faces list --api-key faces_your_key_here

```