facet installs, verifies, authors, and publishes facets for any AI coding tool with an adapter. Projects declare what they depend on in facets.json and get reproducible installs from facets.lock.
Facet management
facet install
Install everything the project declares
facet add
Add a facet and install it in one step
facet remove
Remove a facet and the files it owns (alias
facet rm)facet update
Move facets to newer releases (alias
facet upgrade)facet search
Find published facets in the registry
facet list
Show what is declared and what resolved
Adapters
facet adapter add
Connect an AI coding tool
facet adapter list
See what is connected, and what needs repair
facet adapter remove
Disconnect a tool
Authentication
facet login
Store a registry token
facet whoami
Print the signed-in identity
facet logout
Remove the saved credential
Authoring
facet create
Scaffold a new facet project
facet edit
Interactive authoring workbench
facet modify
Scriptable manifest edits
facet build
Validate and package a facet archive
facet publish
Publish a built facet to the registry
CLI
facet instructions
Print CLI usage guidance for AI agents
facet help
Command and flag help
facet self-update
Update the CLI binary (alias
facet self-upgrade)Exit codes
Every command uses the same convention.
Failures print three lines on stderr:
error:, a code= token for log searching, and a fix: action.
The one exception is facet self-update, which dispatches to your installer or package manager and passes its exit code through, so it can also exit with a code this table does not define.
See also
- Environment variables
- Troubleshooting
- Roadmap for planned commands