FacetDocs

The command line

Facet includes a command, facet, that does everything an assistant does: build, change, check, render and export designs, with or without the app open. You only need it to use Facet from Terminal or scripts; assistants connected through Connect your AI do not.

Install it

Choose Facet › Install Command Line Tool…. Facet adds facet to the folder Terminal looks in:

  • If you use Homebrew, Facet links it into Homebrew's folder, with no password.
  • Otherwise Facet asks for your Mac password once, to create /usr/local/bin/facet, the standard place for commands every app can use.

Open a new Terminal window and check:

facet --help

The command lives inside the app (/Applications/Facet.app/Contents/Helpers/facet), so it updates with Facet and is always the same version as the app. If you installed Facet with Homebrew, facet is already installed.

See what is set up

facet setup

lists each assistant Facet found and whether it is connected, whether the skill is installed, and where facet is. The same command connects and disconnects them:

facet setup connect claude-code     # or claude-desktop, codex, cursor, vscode, all
facet setup disconnect all
facet setup repair                  # after moving Facet
facet setup cli                     # the same as Install Command Line Tool…

Add --json to any of them for output a script can read.

Use it

Start with Your first design and The loop. Every command is on the Commands page; facet guide prints the same reference, and facet COMMAND --help explains one.