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.
Connect says Facet must be in Applications
AI apps remember where Facet is, so Facet connects them only from the Applications folder (or your own Applications folder in your home folder). Move Facet there, open it from there, and connect again.
My assistant says it has no Facet tools
- In Facet, open Facet › Connect AI Apps…. If the app shows Repair, click it; if it shows Connect, click it.
- Quit the assistant completely (⌘Q, not just closing its window) and open it again. Claude, ChatGPT and Codex read their tools only at startup.
- In Terminal,
facet setupshows what Facet set up for each app. - Claude (desktop app) writes what went wrong to its logs folder,
~/Library/Logs/Claude/(the file withfacetin 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).
"Opened read-only; update Facet to edit"
The file was saved by a newer Facet. This build shows it (a Read-only chip sits beside its name) and exports it, but will not write it, so nothing you change by hand or from an assistant is saved: update Facet (Facet › Check for Updates…), or save a copy in this build's format with facet --doc f.facet save --to copy.facet, which opens editable and leaves the original as it was. An assistant's change is refused with READ_ONLY. A file holding a part this build cannot read at all is refused with the part's name and both versions.
Facet quit unexpectedly
macOS keeps a crash report under Console › Crash Reports (~/Library/Logs/DiagnosticReports/Facet-*.ips). Attach it to an issue at github.com/uxfreak/facet; every release keeps the symbols that turn it into function names and lines, so nothing else is needed.
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.