FacetDocs

Troubleshooting

"Facet can't be opened"

Facet is notarized by Apple, so a downloaded copy asks once and opens. If macOS refuses instead, open System Settings › Privacy & Security, scroll to the message about Facet and click Open Anyway. Download Facet again from faux.design if the message says the file is damaged: the download was cut short.

Facet asks to move to Applications

Facet is running from the download window or the Downloads folder. Click Move to Applications: from anywhere else it cannot update itself, and your AI apps cannot find it.

My assistant says it has no Facet tools

  1. In Facet, open Facet › Connect AI Apps…. If the app shows Repair, click it; if it shows Connect, click it.
  2. Quit the assistant completely (⌘Q, not just closing its window) and open it again. Claude, ChatGPT and Codex read their tools only at startup.
  3. In Terminal, facet setup shows what Facet set up for each app.
  4. Claude (desktop app) writes what went wrong to its logs folder, ~/Library/Logs/Claude/ (the file with facet in its name).

My assistant edits the wrong design

The Facet tools act on the design in front in Facet. Click the design's tab, or name the file in your request ("in Welcome.facet, …"); assistants can list your open designs and open others.

macOS asks whether an app may access a folder

When an assistant opens a design in Documents, Desktop or Downloads for the first time, macOS asks whether that app (for example Claude) may access the folder. Allow it, or keep designs in Documents › Facet and allow it once.

"facet: command not found"

The command is not installed, or Terminal was open before it was. Choose Facet › Install Command Line Tool…, then open a new Terminal window. The command always works by its full path: /Applications/Facet.app/Contents/Helpers/facet.

Text shows in a different font

Facet downloads Google Fonts the first time a design uses them; until then, and offline, it uses a stand-in and the design shows a font warning. Reconnect to the internet and reopen the design. Fonts that are not on Google Fonts must be installed on your Mac (double-click the font file).

Start over

facet setup disconnect all removes Facet from every assistant; Facet › Connect AI Apps… connects them again. To reset Facet completely, uninstall and install again; your designs are never removed.