Versioned plugin registry for YoloShell,
modeled on the CocoaPods Specs repository. Each published plugin version is an
immutable spec under Specs/<id>/<version>.json; the spec records the exact
plugin manifest and the source repository, path, tag and commit.
Specs/
web.client/
0.1.0.json
scripts/
validate.py
check-lines.sh
schema_version: always1.id: dotted lowercase plugin id, for exampleweb.client;yolo.is reserved.version: semver, for example0.1.0.name,description: must match the plugin manifest.source.repository: GitHub HTTPS repository containing the plugin.source.path: plugin directory inside that repository.source.tag: release tag for this version.source.commit: exact 40-character commit SHA.manifest: the completeyolo-plugin.jsondocument for that version.
- Tag the plugin source repository for the new version.
- Add
Specs/<id>/<version>.jsonwith the exact manifest from that tag. - Run
python3 -I scripts/validate.pyandsh scripts/check-lines.sh. - Open a pull request. Published version files are immutable; fix a release by publishing a new version, not by editing an existing spec.
| Id | Version | Source |
|---|---|---|
web.client |
0.1.3 |
YoloShellWeb |
web.client |
0.1.2 |
YoloShellWeb |
web.client |
0.1.1 |
YoloShellWeb |
web.client |
0.1.0 |
YoloShellWeb |
web.client 0.1.0 pinned a client-only source root; the client imports the
sibling sdk/, so an installed 0.1.0 plugin cannot start. Use 0.1.1 or newer.
Yolo's yolo plugin install consumes these specs:
yolo plugin install web.client --trust
yolo plugin install web.client --version 0.1.3 --trust
# a fork or test registry
yolo plugin install web.client --registry <git-url> --trustThe installer clones this registry, resolves the newest version unless
--version is given, clones the pinned source commit, verifies the spec against
the source manifest, copies the plugin into a private managed directory and
prints the source and digest. It requires the explicit --trust preview before
linking. Installing over a linked version stops and restarts a running plugin
when its manifest declares a stop action. yolo plugin link <dir> --trust
remains available for local plugin development. The web client is a Bun
process; bun must be on PATH when Yolo starts it. Its token persists across
restarts; delete the token file to rotate it.
MIT. See LICENSE.