gum logofield manual
Reference`gum plugin`Google APIs for agents and terminals

gum plugin

Generated from gum schema --json. Do not edit this page by hand; run make 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

bash
gum plugin

Parent

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

See also