Skip to main content
​
2026-04-20
Update
New install URL and cross-platform support

​
New install URL

The CLI installer has moved to a new home at agentfacets.io/install. If you previously bookmarked the install URL, update it to:
curl -fsSL https://agentfacets.io/install | bash
This method works on macOS and Linux. For Windows or any platform with Node.js, you can install via npm:
npm install -g agent-facets
The download link on the docs site has been updated automatically.
​
2026-04-20
Feature
Alpha install pipeline

​
facet add and facet install

You can now add facets from external sources and install them into your AI coding tools.facet add resolves facets from GitHub repositories, Git URLs, and local file paths. It updates your project’s facets.json while preserving any hand-edited comments.
facet add github:owner/repo
facet add git+https://github.com/owner/repo.git
facet add file:../local-facet
facet install reads your facets.json, builds each facet, and materializes assets into every configured adapter. It includes:
  • Lockfile diffing — only changed assets are written
  • Best-effort rollback — if something fails mid-install, changes are reversed
  • Concurrent install protection — an atomic lock prevents two installs from running at once
  • --dry-run — preview what will change without touching disk
  • --verbose — detailed pipeline output for debugging
See the facet add and facet install CLI reference for details.
​
2026-04-18
Update
Faster adapter installs

​
Self-contained adapter bundles

Adapters now ship as fully self-contained bundles with all dependencies inlined. When you run facet adapter install, the CLI uses a prebuilt fast path that skips the build step entirely — falling back to a full rebuild only if needed.This also means adapter installs no longer leave build artifacts in your source tree.See the environment variables reference for configuring the adapter install location with FACETS_ADAPTERS_DIR.
​
2026-04-17
Update
Codex adapter

​
Codex adapter (early access)

A third first-party adapter for Codex is now available. You can install it with:
facet adapter install codex
Full install support (facet install asset materialization) is coming soon — Codex appears in the adapter picker but is not yet selectable for facet installation. See the adapter install reference for all built-in adapter names.
​
2026-04-17
Feature
Adapter system

​
Adapter SDK and first-party adapters

Adapters are the bridge between facets and your AI coding tool. Each adapter knows where and how to write assets for a specific tool.The first supported adapters are Claude Code, OpenCode, and Codex. When you run facet install, the CLI materializes your facet assets into the correct locations for each adapter you’ve installed.You can manage adapters with:
facet adapter install
facet adapter list
facet adapter remove <name>
Third-party adapters use the same installation and loading mechanism as first-party ones — install via npm, Git URL, or local path.See the adapter CLI reference for more.
​
2026-04-10
Update
Self-contained archives

​
Self-contained .facet archives

The .facet build output is now a single self-contained archive. The build manifest is embedded inside the archive rather than shipped as a separate file, making distribution simpler. You can extract the manifest for debugging with --emit-manifest during build.See the facet build CLI reference.