> ## 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 list

> List declared facets and their versions

## Usage

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

Shows all facets declared in `facets.json` for the current project. No network calls are made.

## Exit codes

| Code | Meaning                                                                                                                                                                                              |
| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `0`  | Listed successfully — including an empty project or no `facets.json` at all (a hint is printed). A malformed `facets.lock` is a warning, not a failure: the listing falls back to source specifiers. |
| `1`  | Positional arguments were given, `facets.json` is malformed, or its `manifestVersion` is one this CLI does not understand (upgrade the CLI).                                                         |

## What it does

<Steps>
  <Step title="Read facets.json">
    Loads the project manifest from the current directory.
  </Step>

  <Step title="Read facets.lock (if present)">
    When a lockfile exists, resolved versions from the [lockfile](/specification/lockfile) are displayed instead of the raw manifest specifier.
  </Step>

  <Step title="Display entries">
    Each facet is listed with its name and resolved version (or source specifier if not yet installed). Entries carrying [materialization overrides](/specification/materialization#recording-intent) show their source the same way a plain entry does.
  </Step>
</Steps>

<Note>
  `facet list` reports declared facets and versions only. It does not yet show which assets a facet aliases or omits — read the `materialization` blocks in `facets.json`, or the per-asset dispositions in `facets.lock`, for that.
</Note>

## See also

* [`facet add`](/cli/add) -- add a facet to the project.
* [`facet install`](/cli/install) -- install all declared facets.