Quickstart

Install, add, and use your first facet

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.

1. Install the CLI

   curl

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

   npm install -g agent-facets
   

   bun add -g agent-facets
   

   Verify it:

   facet --version
   
2. 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 adapter 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
   
3. Use it

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

   Inside an agent harness

   /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.