Add plugin helper with agent skill for updating plugins

2026-06-14 10:26:22 -07:00
parent a9881ebec4
commit caaa4a6558
23 changed files with 1604 additions and 0 deletions
@@ -0,0 +1,37 @@
+# plugin-helper
+
+`plugin-helper` is an early Python CLI for managing Beat Saber plugins in a mounted Windows BSManager install.
+
+The first implementation focuses on safe local workflows:
+
+- discover BSManager instances
+- scan existing `Plugins/` and `Libs/` files
+- read checked-in registry and per-version lockfiles
+- generate a machine-readable install plan from local release assets
+- apply exactly that plan with backups and install state
+- uninstall only files recorded in install state
+- back up `UserData` separately
+
+Default BSManager instance root:
+
+```text
+/home/pleb/Windows/Users/pleb/BSManager/BSInstances
+```
+
+Override with `--instances-root` or `PLUGIN_HELPER_INSTANCES_ROOT`.
+
+## Quick Start
+
+```sh
+python -m plugin_helper instances
+python -m plugin_helper scan --instance 1.40.8
+python -m plugin_helper plan --instance 1.40.8 --state-dir .state
+```
+
+Install assets are currently expected to already exist locally, usually under:
+
+```text
+.state/instances/<instance>/downloads/
+```
+
+Future milestones will add GitHub release discovery and download.