thv ai-plugin sync

Restore project plugins to match the lock file

Synopsis

Restore a project's installed plugins to match toolhive.lock.yaml.

Missing or drifted plugins are reinstalled at their pinned digest. Use --check to report drift without installing anything (suitable for CI). Use --adopt to record lock entries for existing unmanaged installs, and --prune to remove installs no longer present in the lock file.

Unless --check is set, sync 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).

thv ai-plugin sync [flags]

Options

      --adopt                 Write lock entries for existing unmanaged project-scope installs
      --allow-unsigned        Record plugins as unsigned in the lock file: when adopting installs whose signature state cannot be established (--adopt), and when repairing an entry that records no trust decision and whose content is unsigned
      --check                 Report drift without installing, writing, or removing anything
      --clients string        Comma-separated target client apps (e.g. claude-code,opencode), or "all" for every available client
      --format string         Output format (json, text) (default "text")
  -h, --help                  help for sync
      --project-root string   Project root path (default: auto-detected from the current directory)
      --prune                 Remove installs no longer present in the lock file
      --yes                   Skip the confirmation prompt (required when not running interactively)

Options inherited from parent commands

      --debug   Enable debug mode