Skip to main content
By the end of this page you will have the facet CLI installed, a facet added to your project, and a new slash command working in your AI coding tool.
1

Install the CLI

Verify it:
2

Add a facet

From your project directory, add a facet by name from the registry with facet add:
The first time you run this with no connected, facet add opens a picker so you can choose your AI tool (claude-code, opencode, or codex) before installing.
Once an adapter is connected, facet add installs the facet into your tool:
3

Use it

Run the command inside your agent harness OR from your terminal with Claude Code or OpenCode:
That is your first facet installed and running.

​
Next steps

Key concepts

Facets, the two project files, assets, and adapters.

Set up publishing

Install adapters and mint a token so you can publish your own facets.

Create a facet

Scaffold, author, build, and verify a facet of your own.

Install facets

Add, pin, reinstall, and remove facets in a project.

Private facets

Share facets with just yourself or your team.

Hit a snag?

Fixes for the most common CLI errors.