Facets

A package manager and toolkit for facets — modular skills, agents, commands, and tools that extend AI coding assistants.

Documentation

Full documentation is available at agentfacets.io.

Quickstart

# Install the CLI
npm install -g agent-facets

Now you can install facets from https://facet.cafe!

Packages

Package	NPM	Description
CLI	agent-facets	CLI tool for managing facets
Core	@agent-facets/core	Schemas, loaders, and validators
Brand	@agent-facets/brand	Agent Facets branding and styles

Development

Prerequisites

• mise — manages tooling (Bun, lefthook) via mise.toml

Setup

# Install Bun + lefthook
mise install

# Install dependencies + set up git hooks
bun install

# Run the CLI locally (runs source directly, no compilation needed)
bun dev --version
bun dev build ./my-facet

# Run lint, typecheck, build, and tests
bun check

Publishing

This project uses changesets for versioning and publishing. See the changeset README for more details.

bun change          # create a changeset describing your changes

When changesets are merged to main, CI will automatically open a version PR. Merging that PR creates version tags, which trigger per-package publishing to npm.

See CONTRIBUTING.md for more details.

License

MIT