Skip to main content

​
Usage

facets list

​
What it does

Displays all facets declared in your project’s facets.yaml, showing:
  • Name and version
  • Source — local or remote
  • Install status — installed or not installed
  • Description — if defined in the manifest
  • Requires — prerequisite commands, if any

​
Example output

  viper v1.2.0 (remote) [installed]
    Planning and execution framework for AI agents
    requires: gh --version
  my-facet v0.1.0 (local) [not installed]
    A custom project-specific facet

​
How it works

This command performs a three-pass scan with no network calls:
  1. Scans .facets/*/facet.yaml for local facets
  2. Iterates facets.yaml remote entries and loads from cache (~/.cache/facets/)
  3. Picks up any facets.yaml local entries not found in step 1
For each facet, it checks whether all expected resources exist in .opencode/ to determine install status. If no facets are declared, it prints “No facets declared.”