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

> Upgrade installed facets to newer versions

## Usage

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

<Warning>
  This command is not yet implemented. Running it prints a notice and exits. It is on the roadmap for a future release.
</Warning>

## Exit codes

| Code | Meaning                                                               |
| ---- | --------------------------------------------------------------------- |
| `0`  | Always -- the command prints its not-yet-implemented notice and exits |

## Planned behavior

`facet upgrade` will re-resolve version specifiers in `facets.json` against the registry and update `facets.lock` to the newest versions that satisfy each specifier ([resolution semantics](/specification/commit#resolve)). It is the complement to `facet install`, which honors existing lockfile pins.

Until `facet upgrade` ships, you can upgrade a specific facet manually:

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Re-add at a new version (updates both facets.json and facets.lock).
facet add viper-plans@2.0.0

# Or widen the specifier and reinstall.
# Edit facets.json to change "1.2.3" to "2.*", then:
facet install
```

## See also

* [`facet install`](/cli/install) -- install from the current lockfile.
* [`facet add`](/cli/add) -- add or re-add a facet at a specific version.