# atmos plugin list

List package selections and local `path` packages without network access.

> ⚠️ Experimental

## Usage

```shell
atmos plugin list [--format table|json|yaml|csv|tsv]
```

## Flags

- **--format**
  Output format: table (default), json, yaml, csv, or tsv. Set 
  ATMOS_PLUGIN_FORMAT
   to change the default; an explicit flag takes precedence.

Interactive table output uses the shared Atmos list styling. When piped, table output becomes plain tab-separated rows. JSON and YAML retain the complete package metadata, including release details.

Interactive tables show a green dot for installed plugins, a warning dot for missing packages, an information dot for packages that run from a local `path`, and a muted dot for disabled plugins. The status word remains visible with or without color.

### States

- **installed**
  The locked release is in the cache.
- **missing**
  The package is declared but not installed or not locked yet.
- **corrupt**
  The cached release no longer matches the lock. Run 
  atmos plugin install
   to repair it.
- **path**
  The active configuration sets 
  plugins.packages.<alias>.path
  , so the package runs from that directory instead of a release. The name and version come from the manifest in the directory, and the JSON and YAML output include the resolved 
  path
  . The lock, the cache, and signatures do not apply. See the 
  plugin development tutorial
  .
- **broken**
  A 
  path
   package whose 
  plugin.yaml
   cannot be read. Atmos warns with the resolved directory; check the path and run 
  atmos plugin build <directory>
  .
- **disabled**
  The package sets 
  enabled: false
  .

## Examples

```shell
atmos plugin list
atmos plugin list --format=json
```