Skip to main content
Version: v0.26

Using Plugins

Ignite plugins offer a way to extend the functionality of the Ignite CLI. There are two core concepts within plugins : Commands and Hooks. Where Commands extend the cli's functionality, and Hooks extend existing command functionality.

Plugins are registered in an Ignite scaffolded Blockchain project through the plugins.yml, or globally through $HOME/.ignite/plugins/plugins.yml.

To use a plugin within your project, execute the following command inside the project directory:

ignite plugin add github.com/project/cli-plugin

The plugin will be available only when running ignite inside the project directory.

To use a plugin globally on the other hand, execute the following command:

ignite plugin add -g github.com/project/cli-plugin

The command will compile the plugin and make it immediately available to the ignite command lists.

Listing installed plugins

When in an ignite scaffolded blockchain you can use the command ignite plugin list to list all plugins and there statuses.

Updating plugins

When a plugin in a remote repository releases updates, running ignite plugin update <path/to/plugin> will update a specific plugin declared in your project's config.yml.