Skip to main content

​
What is Facets?

Facets is a package manager and toolkit for facets — modular bundles of skills, agents, commands, and tools that extend AI coding assistants. Think of facets like plugins: each one adds new capabilities to your assistant, and Facets manages discovering, installing, and updating them.

​
Packages

Facets is distributed as two packages:
PackagenpmDescription
Facets CLI@ex-machina/facetsCore library and CLI for managing facets
MCP Server@ex-machina/facets-mcpMCP server that exposes facet operations to AI assistants
The CLI is what you use directly to manage facets in your project. The MCP server lets your AI coding assistant manage facets on your behalf — adding, installing, and updating facets through natural language.

​
How it works

  1. Add a remote facet by URL — Facets fetches and caches the manifest and all its resources
  2. Install the facet — resources (skills, agents, commands, tools) are materialized into your project’s .opencode/ directory
  3. Use the facet — your AI assistant picks up the new capabilities automatically
Facets tracks dependencies in a facets.yaml file and locks versions in a facets.lock file, similar to how package.json and lock files work in the Node.js ecosystem.

​
Next steps

Quickstart

Get up and running in under a minute

Core Concepts

Understand how facets, manifests, and installation work

CLI Reference

Full reference for every CLI command

MCP Server

Let your AI assistant manage facets