> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentfacets.io/llms.txt
> Use this file to discover all available pages before exploring further.

# facet adapter list

> Lists installed adapters

## Usage

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
facet adapter list
```

Lists all installed adapters by inspecting the adapter base directory, `$FACET_DIR/adapters/` (see [environment variables](/cli/env) for the `FACET_DIR` layout). Each entry shows the adapter's declared adapter API and whether this CLI supports it:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Installed adapters:
  claude-code  api 0.1      supported
  codex        api 0.0      unsupported — reinstall: facet adapter install codex
  opencode     api missing  unsupported — reinstall: facet adapter install opencode
  my-tool      api unknown  broken (bundle failed to load) — reinstall: facet adapter install my-tool
```

## Output columns

* **API** — the adapter's declared adapter API (`api 0.1`), or `api missing` (no declaration — typically a bundle installed before API versioning), `api malformed ("…")` (a declaration that isn't a valid API identifier), or `api unknown` (the bundle could not be read). An adapter declaring the earlier positional `0.0` is shown as `api 0.0` with an `unsupported` status — rebuild it against a `0.1` SDK release and reinstall.
* **Status** — `supported` (usable by this CLI), `unsupported — reinstall: <command>` (the adapter's API declaration is missing, malformed, or names an API this CLI does not support), or `broken (<reason>) — reinstall: <command>` (invalid installation metadata, a missing active bundle, or a bundle that failed to load).

Listing stays available when entries are incompatible or broken — run it to find the best available `facet adapter install <specifier>` command next to each failing entry.

<Note>
  If an adapter was originally installed with an **exact** npm version, such as `my-adapter@1.2.3`, its printed command preserves that exact pin. Re-running it fails again when that release is incompatible rather than silently upgrading. Drop or change the exact selector — use the bare package name, `@latest`, or a wider selector such as `1.*` — so the CLI can select the highest compatible release. Git and local commands rebuild the same supplied source, so that source must itself be updated when incompatible.
</Note>

## Exit codes

| Code | Meaning                                               |
| ---- | ----------------------------------------------------- |
| `0`  | Always — listed successfully, including an empty list |

## See also

* [`facet adapter install`](/cli/adapters/install) -- install an adapter.
* [`facet adapter remove`](/cli/adapters/remove) -- remove an installed adapter.