atmos plugin list

List package selections and local path packages without network access.

Experimental

atmos plugin list --help

Usage

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

atmos plugin list
atmos plugin list --format=json