Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.faces.app/llms.txt

Use this file to discover all available pages before exploring further.

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

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: 
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: 
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 con la API: GET /api/v1/teams.
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.

​
Verificar

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
# Usando variables de entorno
export FACES_API_KEY="faces_your_key_here"
faces list

# Usando flags
faces list --api-key faces_your_key_here