# atmos plugin run

Execute an installed plugin’s selected command and preserve its exit code.

> ⚠️ Experimental

## Usage

```shell
atmos plugin run <alias> -- [arguments...]
```

Atmos identifies the selected command and its description on stderr before
execution. The plugin's own stdout and exit code remain available to callers.
The OIDC starter exports an `about` command: running it displays what the plugin
supports and how to authenticate. It does not perform a login. Configure an
identity using the plugin and run `atmos auth login --identity <identity>` to
authenticate.

## Arguments and flags

- **alias**
  Installed package alias. If a package exports multiple commands, select one with plugins.packages.<alias>.command.
- **arguments**
  Arguments after -- are passed unchanged to the plugin command.

## Examples

```shell
atmos plugin run corporate --
```