Skip to main content

​
Usage

facet adapter <install|list|remove> [args]
Manages adapter installations. An adapter is an AI coding tool (OpenCode, Claude Code, Codex, etc.) that wraps around an LLM. Adapters define where assets and configuration live on disk.

​
Subcommands

​
facet adapter install

facet adapter install <specifier>
Installs an adapter from the given specifier. The install flow downloads the source, bundles it into a self-contained adapter.js, verifies it exports a valid adapter, and places it in ~/.facets/adapters/<name>/. Specifier formats:
FormatExampleDescription
Built-in nameopencodeResolves to the first-party npm package
npm package@acme/adapter-customDownloads from the npm registry
Git URLgit+https://github.com/user/repo.gitClones the repository
Git URL with refgit+https://github.com/user/repo.git#v1.0.0Clones at a specific tag/branch
Local path./path/to/adapterUses a local directory
Built-in names:
  • opencode — OpenCode adapter (@agent-facets/adapter-opencode)
  • claude-code — Claude Code adapter (@agent-facets/adapter-claude-code)
  • codex — Codex adapter (@agent-facets/adapter-codex)

​
facet adapter list

facet adapter list
Lists all installed adapters by scanning ~/.facets/adapters/.

​
facet adapter remove

facet adapter remove <name>
Removes an installed adapter by deleting its directory from ~/.facets/adapters/.