thv ai-plugin upgrade

Upgrade project plugins to newer pinned content

Synopsis

Re-resolve a project's lock entries and install newer content where available.

Plugins pinned to an immutable reference (an OCI digest or a full git commit hash) are reported not-upgradable — there is nothing newer to resolve to. Use --preview to see what would change without persisting anything (OCI sources are still fetched into the local artifact store to compare digests), and --allow-ref-change to permit the artifact moving to a different repository (a version bump within the same repository is not a change this guard blocks). --fail-on-changes evaluates the same plan and never installs: it is a CI freshness gate.

Unless --preview is set, upgrade prompts for confirmation before installing — plugin content is a set of AI-followed instructions. Pass --yes to skip the prompt (required in non-interactive contexts such as CI).

Requires TOOLHIVE_PLUGINS_LOCK_ENABLED=true.

thv ai-plugin upgrade [plugin-name...] [flags]

Options

      --allow-ref-change      Permit the artifact to move to a different repository during upgrade
      --clients string        Comma-separated target client apps (e.g. claude-code,opencode), or "all" for every available client
      --fail-on-changes       Report what would change without installing anything; a CI freshness gate
      --format string         Output format (json, text) (default "text")
  -h, --help                  help for upgrade
      --preview               Report what would change without persisting anything (OCI sources are still fetched to compare digests)
      --project-root string   Project root path (default: auto-detected from the current directory)
      --yes                   Skip the confirmation prompt (required when not running interactively)

Options inherited from parent commands

      --debug   Enable debug mode