thv skill upgrade

Upgrade project skills to newer pinned content (experimental)

Synopsis

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

Experimental: requires TOOLHIVE_SKILLS_LOCK_ENABLED=true on the ToolHive server while the lock file feature rolls out.

Skills 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 resolved reference itself changing (e.g. a registry entry repointed at a different repository). --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 — skill content is a set of AI-followed instructions. Pass --yes to skip the prompt (required in non-interactive contexts such as CI).

thv skill upgrade [skill-name...] [flags]

Options

      --allow-ref-change      Permit the resolved reference itself to change 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