Setup

What you need before adding, authoring, or publishing facets. To just try a facet, the Quickstart is faster.

Install the CLI

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

npm install -g agent-facets

bun add -g agent-facets

Keep it current with facet self-update. The authoring commands need v0.24.0 or newer.

facet --version
facet self-update

Connect an adapter

An adapter materializes facets into one AI tool. Install one per machine:

facet adapter add claude-code   # or: opencode, codex
facet adapter list

Without an adapter, facet add opens a picker in a terminal and fails in CI.

Adding public facets needs no account. Sign in to publish your own facets and reach private ones you have access to.On macOS or Linux:

facet login --browser
facet whoami

Follow the verification page and complete account setup if requested. See facet login for manual browser verification and personal access token entry on Windows.For CI and scripts, create a personal access token in your account settings at agentfacets.io and supply FACET_TOKEN. Do not run interactive login in CI.

Verify your setup

facet --version        # CLI is installed and recent
facet adapter list     # at least one adapter connected
facet whoami           # signed in

Next steps

Install facets

Add, pin, reinstall, and remove facets.

Create a facet

Scaffold, author, build, and verify.

⌘I

Agent Facets

Guides

Concepts

Adapter Development

Protocol API

Verify your setup

Next steps

Install facets

Create a facet

​Verify your setup

​Next steps

Install facets

Create a facet

Verify your setup

Next steps