Quickstart

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.

Install the CLI

curl -fsSL https://agentfacets.io/install | bash

npm install -g agent-facets

bun add -g agent-facets

Verify it:

facet --version

Add a facet

From your project directory, add a facet by name from the registry with facet add:

facet add cowsay

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:

cowsay installed. Updated facets via 1 adapter  ✓
  1 installed · 4 assets written
  + 1 skill · 1 agent · 2 commands

Use it

Run the command inside your agent harness OR from your terminal with Claude Code or OpenCode:

/cowsay hey there
/cowchat how's the weather?

claude -p "/cowsay hey there"

opencode run --command cowsay "hey there"

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.

⌘I

Agent Facets

Guides

Concepts

Adapter Development

Next steps

Key concepts

Set up publishing

Create a facet

Install facets

Private facets

Hit a snag?

​Next steps

Key concepts

Set up publishing

Create a facet

Install facets

Private facets

Hit a snag?

Next steps