hermes plugins Command — Complete Reference & Examples

Overview

hermes plugins manages Hermes Agent plugins — extensions installed from Git repositories that add new capabilities to the agent. You can install, update, remove, list, enable, and disable plugins.

Usage

hermes plugins [-h] {install,update,remove,rm,uninstall,list,ls,enable,disable} ...

Subcommands

install <source>

Install a plugin from a Git URL or owner/repo.

hermes plugins install owner/repo
hermes plugins install https://github.com/owner/hermes-plugin.git

update [name]

Pull the latest changes for an installed plugin. Without a name, updates all installed plugins.

hermes plugins update my-plugin
hermes plugins update

remove / rm / uninstall <name>

Remove an installed plugin. All three names are aliases of the same action.

hermes plugins remove my-plugin
hermes plugins rm my-plugin
hermes plugins uninstall my-plugin

list / ls

List installed plugins. ls is an alias of list.

hermes plugins list
hermes plugins ls

enable <name>

Enable a disabled plugin.

hermes plugins enable my-plugin

disable <name>

Disable a plugin without removing it.

hermes plugins disable my-plugin

Examples

# List installed plugins
hermes plugins list

# Install a plugin from a GitHub repository
hermes plugins install owner/hermes-plugin

# Update all installed plugins
hermes plugins update

# Disable a problematic plugin
hermes plugins disable my-plugin

# Re-enable it later
hermes plugins enable my-plugin

# Remove a plugin completely
hermes plugins remove my-plugin

Tips

• Plugins are installed from Git repositories, not a centralized registry.
• Disabling is safer than removing while troubleshooting — the plugin stays installed and can be re-enabled instantly.
• Update plugins regularly to receive bug fixes and compatibility improvements.
• A disabled plugin is not loaded, so it does not affect startup or behavior.
• After installing or enabling a plugin, start a new session (or restart the gateway) for it to take effect.