faces-cli
v1.2.1
Published
CLI for the Faces AI platform
Downloads
382
Readme
faces-cli
Command-line interface for the Faces platform.
Installation
npm install -g faces-cliRequires Node.js ≥ 18.
Quick start
faces auth login
faces face list
faces chat chat myface -m "Hello"Commands
faces auth login / logout / register / whoami / refresh
faces face create / list / get / update / delete / stats / upload
faces chat chat / messages / responses
faces compile doc create / list / get / prepare / sync / delete
faces compile thread create / list / message / sync
faces keys create / list / revoke / update
faces billing balance / subscription / quota / usage / topup / checkout / card-setup / llm-costs
faces account state
faces config set / show / clearRun faces <command> --help for details on any command.
Authentication
Login stores a JWT at ~/.faces/config.json (shared with the Python faces-cli).
You can also authenticate via environment variables:
export FACES_API_KEY=your_api_key
export FACES_TOKEN=your_jwt
export FACES_BASE_URL=https://api.faces.sh # optional overrideLicense
MIT — Copyright (c) 2026 Headwaters Lab Inc.
