Skip to main content
​
2026-04-20
Feature
Install pipeline and adapter system

​
facet install and facet add

You can now install facets end-to-end. facet add registers a facet source (GitHub repo, Git URL, or local path) in your project’s facets.json, and facet install resolves, builds, and materializes assets into every connected AI tool.
  • Source specifiers — github:, git+https://, and file: are all supported.
  • Dry run — pass --dry-run to preview the install plan without touching disk.
  • Verbose logging — pass --verbose to see a full pipeline trace, useful for debugging.
  • Rollback on failure — if something goes wrong mid-install, the CLI rolls back changes automatically.
  • Concurrent safety — an install lock prevents two facet install runs from interfering with each other.
See the CLI reference for usage details.
​
2026-04-17
Feature
Adapter system

​
Adapter architecture

Adapters replace the previous “harness” concept. An adapter is a plugin that tells the facet CLI how to talk to an external AI tool — where assets live on disk, how configuration is structured, and how to read and write files.First-party adapters ship for Claude Code, OpenCode, and Codex (install support coming soon for Codex). Third-party adapters use the same installation and loading mechanism as first-party ones.See adapters overview and the adapter install reference for details.
​
2026-04-17
Feature
Adapter management CLI

​
facet adapter install, list, and remove

New CLI commands let you manage adapters independently:
  • facet adapter install <specifier> — install from a built-in name, npm package, Git URL, or local path.
  • facet adapter list — show all installed adapters.
  • facet adapter remove <name> — uninstall an adapter.
If no adapters are installed when you run facet install, an interactive picker appears so you can select which AI tools to connect.See the adapter CLI reference for full usage.