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

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

<Steps>
  <Step title="Install the CLI">
    <CodeGroup>
      ```sh curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
      curl -fsSL https://agentfacets.io/install | bash
      ```

      ```sh npm theme={"theme":{"light":"github-light","dark":"github-dark"}}
      npm install -g agent-facets
      ```

      ```sh bun theme={"theme":{"light":"github-light","dark":"github-dark"}}
      bun add -g agent-facets
      ```
    </CodeGroup>

    Verify it:

    ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
    facet --version
    ```
  </Step>

  <Step title="Add a facet">
    From your project directory, add a facet by name from the registry with [`facet add`](/cli/add):

    ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
    facet add cowsay
    ```

    <Note>
      The first time you run this with no <Tooltip tip="An adapter is the bridge between facet and a specific AI coding tool — it decides where assets and config land on disk.">adapter</Tooltip> installed, `facet add` opens a picker to connect your AI tool (claude-code, opencode, or codex) before installing.
    </Note>

    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
    ```
  </Step>

  <Step title="Use it">
    Run the command inside your agent harness OR from your terminal with Claude Code or OpenCode:

    <CodeGroup>
      ```text Inside an agent harness theme={"theme":{"light":"github-light","dark":"github-dark"}}
      /cowsay hey there
      /cowchat how's the weather?
      ```

      ```sh Claude Code theme={"theme":{"light":"github-light","dark":"github-dark"}}
      claude -p "/cowsay hey there"
      ```

      ```sh OpenCode theme={"theme":{"light":"github-light","dark":"github-dark"}}
      opencode run --command cowsay "hey there"
      ```
    </CodeGroup>

    That's it — you've installed and used your first facet.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Key concepts" icon="lightbulb" href="/docs/learn">
    What facets and assets are, and when to use each asset type.
  </Card>

  <Card title="Set up publishing" icon="key" href="/guides/setup">
    Install adapters and mint a token so you can publish your own facets.
  </Card>

  <Card title="Create your first facet" icon="hammer" href="/guides/create-your-first-facet">
    Scaffold, author, build, and verify a facet of your own.
  </Card>

  <Card title="Install facets" icon="download" href="/guides/install-facets">
    Add, pin, reinstall, and remove facets in a project.
  </Card>

  <Card title="Hit a snag?" icon="life-buoy" href="/guides/troubleshooting">
    Fixes for the most common CLI errors.
  </Card>
</CardGroup>