# Agent Facets

> A package manager for AI assistant extensions: skills, agents, commands, and MCP servers.

## Docs

- [Changelog](https://docs.agentfacets.io/changelog/index.md): What's new in Agent Facets
- [facet adapter install](https://docs.agentfacets.io/cli/adapters/install.md): Installs an adapter
- [facet adapter list](https://docs.agentfacets.io/cli/adapters/list.md): Lists installed adapters
- [facet adapter remove](https://docs.agentfacets.io/cli/adapters/remove.md): Manage adapter installations
- [facet add](https://docs.agentfacets.io/cli/add.md): Adds one or more facets to `facets.json` and installs them
- [facet build](https://docs.agentfacets.io/cli/authoring/build.md): Build a facet from the current directory
- [facet create](https://docs.agentfacets.io/cli/authoring/create.md): Scaffolds a new facet project
- [facet edit](https://docs.agentfacets.io/cli/authoring/edit.md): Interactive editor for reconciling and authoring a facet
- [facet publish](https://docs.agentfacets.io/cli/authoring/publish.md): Verify a built facet and upload it to the registry
- [Environment Variables](https://docs.agentfacets.io/cli/env.md): Environment variables that configure where facet stores state
- [facet help](https://docs.agentfacets.io/cli/help.md): Show help for the CLI or a specific command
- [Facet CLI](https://docs.agentfacets.io/cli/index.md): `facet` is an open-source CLI for managing and installing **facets**
- [facet install](https://docs.agentfacets.io/cli/install.md): Installs all facets declared in `facets.json`
- [facet list](https://docs.agentfacets.io/cli/list.md): List facets installed in the current project
- [facet login](https://docs.agentfacets.io/cli/login.md): Sign in to the facet registry
- [facet logout](https://docs.agentfacets.io/cli/logout.md): Remove saved registry credentials
- [facet remove](https://docs.agentfacets.io/cli/remove.md): Remove one or more facets from the project
- [facet search](https://docs.agentfacets.io/cli/search.md): Search the registry for published facets
- [facet self-update](https://docs.agentfacets.io/cli/self-update.md): Update the facet CLI to a newer version
- [facet upgrade](https://docs.agentfacets.io/cli/update.md): Upgrade installed facets to newer versions
- [facet whoami](https://docs.agentfacets.io/cli/whoami.md): Print the signed-in identity
- [Architecture](https://docs.agentfacets.io/docs/contributing/architecture.md): The three-layer architecture of Agent Facets  -- protocol, engine, CLI.
- [CI Architecture](https://docs.agentfacets.io/docs/contributing/ci-architecture.md): CircleCI workflow structure, job definitions, and configuration management.
- [Getting Started](https://docs.agentfacets.io/docs/contributing/getting-started.md): Set up the Facets development environment and learn the contribution workflow.
- [Publishing](https://docs.agentfacets.io/docs/contributing/publishing.md): How CircleCI authenticates with npm using OIDC tokens, and how to configure it for new packages.
- [Release Pipeline](https://docs.agentfacets.io/docs/contributing/release-pipeline.md): End-to-end flow from PR merge to npm publish, GitHub Release, and notifications.
- [Agents](https://docs.agentfacets.io/docs/learn/agents.md): Portable agent definitions with role, behavior, and tool configuration
- [Commands](https://docs.agentfacets.io/docs/learn/commands.md): User-invokable workflows that perform specific tasks
- [Key Concepts](https://docs.agentfacets.io/docs/learn/index.md): Asset types, the manifest, text composition, MCP servers, and the facet lifecycle
- [Servers](https://docs.agentfacets.io/docs/learn/servers.md): MCP server references that give AI assistants new tool capabilities
- [Skills](https://docs.agentfacets.io/docs/learn/skills.md): Reusable knowledge and guidelines that shape how AI assistants work
- [Create Your First Facet](https://docs.agentfacets.io/guides/create-your-first-facet.md): Scaffold, write content, build, and verify a facet from scratch
- [Install Facets in Your Project](https://docs.agentfacets.io/guides/install-facets.md): Search, add, and manage facets in your AI coding projects
- [Publish a Facet](https://docs.agentfacets.io/guides/publish-a-facet.md): Build, authenticate, and publish your facet to the registry
- [Agent Facets](https://docs.agentfacets.io/index.md)
- [Pre-Release Alpha](https://docs.agentfacets.io/roadmap/alpha.md)
- [Open Beta](https://docs.agentfacets.io/roadmap/beta.md)
- [Roadmap](https://docs.agentfacets.io/roadmap/index.md): What's available now and what's coming next
- [Stable Release](https://docs.agentfacets.io/roadmap/stable.md)
- [Architecture](https://docs.agentfacets.io/specification/architecture.md): Actors, artifact types, distribution model, and design principles.
- [Introduction](https://docs.agentfacets.io/specification/index.md): The open source Agent Facet specification
- [Install & Resolve](https://docs.agentfacets.io/specification/install.md): How facets are installed, server references resolved, and everything pinned in a lockfile.
- [Integrity Model](https://docs.agentfacets.io/specification/integrity.md): Content hashing, OCI digest pinning, and API surface hashing.
- [Facet Manifest – facet.json](https://docs.agentfacets.io/specification/manifest.md): The manifest format schema -- fields, types, and constraints.
- [Install Pipeline](https://docs.agentfacets.io/specification/pipeline.md): The two-phase plan/commit pipeline: how facets are resolved, verified, materialized, and committed.
- [Publish Flow](https://docs.agentfacets.io/specification/publish.md): How facets are built and published to the registry.
- [MCP Server Assets](https://docs.agentfacets.io/specification/servers.md): Source-mode and ref-mode MCP server publication and execution.
- [Terminology](https://docs.agentfacets.io/specification/terminology.md): Canonical terms used throughout the Facets specification.