# atmos plugin catalog remove

Unlist a package or version without deleting release artifacts.

> ⚠️ Experimental

## Usage

```shell
atmos plugin catalog remove <catalog> <package>
```

## Arguments and flags

- **catalog**
  A 
  plugins.registries
   alias that configures a 
  catalog
  , or an

  oci://
   catalog reference. A bare reference such as 
  registry.example.com/team/catalog:stable

  is rejected with a hint listing the usable aliases, and an alias without a 
  catalog
   is an error.
- **package**
  Canonical package name, such as acme/oidc.
- **--version**
  Unlist only this version; omit to remove the package from discovery. A leading 
  v

  is accepted, so 
  v0.1.0
   and 
  0.1.0
   select the same version. Fails and lists the
  available versions when the version is not in the catalog.

## Publisher coordination

Run catalog mutations through one externally serialized maintainer workflow per catalog. The lock must cover reading the latest inputs, updating the snapshot, and publishing it. Revision and digest rechecks detect an already-stale update; they do not provide atomic compare-and-swap or prevent simultaneous writers from overwriting one another.

Plugin release jobs should publish artifacts independently. Use direct repository discovery when a collection does not need a curated catalog; see [plugin search](search.mdx).

## Examples

```shell
atmos plugin catalog remove corporate acme/oidc --version=0.1.0
atmos plugin catalog remove corporate acme/oidc
```