|
| 1 | +[](https://github.com/sponsors/hyperpolymath) |
| 2 | + |
| 3 | += asdf Tool Plugins |
| 4 | +// SPDX-License-Identifier: MPL-2.0 |
| 5 | +:author: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> |
| 6 | +:revdate: 2026-05-26 |
| 7 | + |
| 8 | +Hyperpolymath's collection of https://asdf-vm.com/[asdf] plugins for installing |
| 9 | +and managing development tools and runtimes across the estate. |
| 10 | + |
| 11 | +Each top-level subdirectory is a standalone asdf plugin. The full set covers |
| 12 | +the languages, runtimes, and tools the hyperpolymath language-policy |
| 13 | +(link:https://github.com/hyperpolymath/standards/blob/main/.claude/CLAUDE.md[CLAUDE.md |
| 14 | +in `hyperpolymath/standards`]) currently endorses, plus some neighbouring |
| 15 | +tools used in supporting infrastructure. |
| 16 | + |
| 17 | +== Installing a plugin |
| 18 | + |
| 19 | +Each plugin is installable directly from this monorepo using the standard |
| 20 | +asdf plugin-add URL form: |
| 21 | + |
| 22 | +[source,bash] |
| 23 | +---- |
| 24 | +asdf plugin add <name> https://github.com/hyperpolymath/asdf-tool-plugins.git |
| 25 | +---- |
| 26 | + |
| 27 | +(Some plugins may require additional setup — see the plugin's own README |
| 28 | +inside its subdirectory.) |
| 29 | + |
| 30 | +== Layout |
| 31 | + |
| 32 | +This is a *consolidated monorepo* — every plugin lives in a sibling |
| 33 | +directory at the top level. Each is autonomous (its own |
| 34 | +`bin/list-all`, `bin/install`, plugin-specific helpers). |
| 35 | + |
| 36 | +Browse the plugin list directly by running: |
| 37 | + |
| 38 | +[source,bash] |
| 39 | +---- |
| 40 | +ls -d */ |
| 41 | +---- |
| 42 | + |
| 43 | +== Status |
| 44 | + |
| 45 | +* **Licence**: MPL-2.0. |
| 46 | +* **Estate role**: development-tooling support; downstream of the |
| 47 | + `hyperpolymath/standards` language-policy. |
| 48 | +* **Audit findings**: see `docs/tech-debt-2026-05-26.md` if present |
| 49 | + (added by the 2026-05-26 estate tech-debt scan). |
| 50 | + |
| 51 | +== Contributing |
| 52 | + |
| 53 | +PRs welcome — see link:CONTRIBUTING.md[CONTRIBUTING.md]. |
| 54 | +All commits must be GPG-signed and follow conventional commits |
| 55 | +(per estate-wide policy in `hyperpolymath/standards`). |
| 56 | + |
| 57 | +== Companion repositories |
| 58 | + |
| 59 | +* link:https://github.com/hyperpolymath/standards[`hyperpolymath/standards`] — canonical estate-wide standards including the language policy. |
| 60 | +* link:https://github.com/hyperpolymath/rsr-template-repo[`hyperpolymath/rsr-template-repo`] — the canonical project scaffold (this repo follows the RSR pattern). |
0 commit comments