> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentfacets.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Facets in Your Project

> Add, pin, reinstall, and remove facets

Bring facets into a project in two moves: connect an adapter for your AI tool, then add the facets you want. This guide walks the whole loop  -- add, list, reinstall, and remove.

> **Using facets in a project? Read the CLI's own agent instructions first.**
>
> ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
> facet instructions usage   # add/update/remove facets; install adapter tooling
> ```
>
> The short version:
>
> ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
> facet adapter install claude-code   # connect your AI tool (once per machine)
> facet add viper-plans               # registry-first: a bare name is a registry facet
> facet add viper-plans@1.2.3         # or pin a version
> facet install                       # after a git clone: materialize from the lockfile
> facet remove viper-plans            # take a facet back out
> ```
>
> See [`facet add`](/cli/add), [`facet install`](/cli/install),
> [`facet remove`](/cli/remove), and [`facet adapter install`](/cli/adapters/install).