gum plugin
Generated from
gum schema --json. Do not edit this page by hand; runmake docs-commands.
Manage gum plugins: install, list, run, and curate third-party subprocess plugins. Installing a plugin launches an untrusted subprocess, so 'install' requires --yes to acknowledge that trust boundary. See the subcommands below.
Usage
gum pluginParent
Subcommands
- gum plugin install - Installs a plugin through an atomic registry update: validates the manifest,
- gum plugin list - List installed plugins
- gum plugin reload - Clears any quarantine state for the named plugin, then spawns the subprocess once via the supervisor to act as a passive canary. A spawn failure re-quarantines the plugin.
- gum plugin remove - Remove a plugin by ID
- gum plugin run - Call a tool on a running plugin
- gum plugin setup - Reads the plugin's credential_descriptors from its manifest, prompts for
- gum plugin transfer-namespace - Updates the namespace_owner binding for <prefix> in the active profile's
- gum plugin unquarantine - Resets quarantined, retry_count, backoff_step, and next_retry_at in plugin-state.json so the plugin can be invoked on the next call. Use when the operator has independently verified the plugin is healthy and wants to bypass the exponential-backoff window.
Flags
| Flag | Type | Default | Help |
|---|---|---|---|
--log-format |
string |
json | Log format: json|text |
--log-level |
string |
info | Log level: debug|info|warn|error (overrides GUM_LOG_LEVEL) |
--profile |
string |
default | Profile name to read/write config under |
