Usage
$FACET_DIR/adapters/, with its declared API and whether this CLI supports it. Listing keeps working when entries are unsupported or broken, which is the point: it prints the command that repairs each one.
Exit codes
Output
declared contract
The adapter’s declared API, or
api missing when there is no declaration, api malformed when it is not a valid identifier, or api unknown when the bundle could not be read.usability
supported, unsupported with a reinstall command, or broken with a reason and a reinstall command.supported means the adapter loads. It does not mean the adapter can configure MCP servers, which fails separately.Details
Reinstall commands preserve your specifier
The printed command reproduces how the adapter was installed. An adapter pinned to an exact npm version keeps that pin, so re-running it fails again rather than silently upgrading. Use the bare name,@latest, or a wider selector such as 1.* to let the CLI choose a compatible release. A git or local adapter rebuilds the same source, so that source has to change.
Troubleshooting
an adapter is listed as unsupported
an adapter is listed as unsupported
Cause: the adapter declares an API this CLI does not support, or declares none at all. This CLI supports exactly
0.3; adapters built against 0.1 or 0.2 wrote files themselves, which the current guarantees cannot be built on.Upgrading the CLI across that boundary marks every installed adapter unsupported at once, first-party ones included.Fix: run the reinstall command printed beside the entry. Nothing is written by any command until this check passes, and facet adapter remove works regardless.an adapter's declared API disagrees with its package
an adapter's declared API disagrees with its package
Cause: the runtime API the bundle stamps does not match what its published package declared, so the release that was selected is not the release that was built.Fix: reinstalling the same version will not help. Report it to the adapter’s author and install a different version.
an adapter is listed as broken
an adapter is listed as broken
Cause: its installation record is invalid, its active bundle is missing, or the bundle failed to load.Fix: run the reinstall command printed beside the entry. If it keeps failing, remove the adapter and add it again.