# list-plugins

## Purpose

Lists the plug-ins available from the Grails standard repository

## Examples

    grails list-plugins

## Description

Usage:

    grails list-plugins
    grails list-plugins -repository=myRepository
    grails list-plugins -installed

Fired Events:

- `StatusUpdate` - When the plug-in list is being refreshed
- `StatusError` - When there was an error updating the plug-in list

Arguments:

- `repository` - The name of the repository used to produce the list of available plugins, otherwise all known repositories will be scanned. See the section on Plugin repositories in the user guide.
- `installed` - List only the plugins that are installed into the current Grails application.

Lists the plug-ins that are installable via the Grails standard repository. Note: This command can take a while to execute depending in your internet connectivity. Typical output looks like this:

    Plug-ins available in the Grails repository are listed below:
    -------------------------------------------------------------
    acegi               <no releases>    --  No description available
    aop                 <no releases>    --  No description available
    autorest            <no releases>    --  No description available
    cache               <no releases>    --  No description available
    cas-client          <0.2>            --  This plugin provides client integrat…
    converters          <0.3>            --  Provides JSON and XML Conversion for…
    dbmapper            <0.1.5>          --  Database relation to domain object…
    dbmigrate           <0.1.2>          --  Database migration tasks

The first column contains the plugin name, the second the version and the last the description. If you require more info about a plug-in you can use the plugin-info command. If you wish to install a plug-in you can use the plug-in name and/or version in combination with the install-plugin.

> Note: If you are behind a proxy you may want to consider using the set-proxy command prior to running this command.