Quickstart

By the end of this page you’ll have the facet CLI installed, a facet added to your project, and a new slash command working in your AI coding tool — in under five minutes.

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 installed, facet add opens a picker to connect 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’s it — you’ve installed and used your first facet.

Next steps

Key concepts

What facets and assets are, and when to use each asset type.

Set up publishing

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

Create your first facet

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

Install facets

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

Hit a snag?

Fixes for the most common CLI errors.

Key ConceptsFacets, assets, and the three asset types

⌘I

Agent Facets

Guides

Asset Types

Next steps

Key concepts

Set up publishing

Create your first facet

Install facets

Hit a snag?

​Next steps

Key concepts

Set up publishing

Create your first facet

Install facets

Hit a snag?

Next steps