From 610c6f17ba23ef894ee464e9e927a50d532219b6 Mon Sep 17 00:00:00 2001
From: Max Rydahl Andersen <max@xam.dk>
Date: Wed, 15 Jul 2026 21:24:48 +0200
Subject: [PATCH] Add jbang-catalog.json and document JBang usage in README

- Add jbang-catalog.json with aliases for bacon, pnc, da, pig (release + snapshot)
- Use ${bacon.version:RELEASE/LATEST} for version pinning via -Dbacon.version
- Document JBang run, install, version pinning, and snapshot usage in README
---
 README.md          | 34 +++++++++++++++++++++++++++++
 jbang-catalog.json | 54 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 88 insertions(+)
 create mode 100644 jbang-catalog.json

diff --git a/README.md b/README.md
index c8fa76dce..fb4403534 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,40 @@ Contributions are welcome! Please see the [Developer's guide](https://github.com
 
 Finally, our [changelog](https://project-ncl.github.io/bacon/changelog.html) lists the changes that happened in releases.
 
+---
+# Installation via JBang
+
+[JBang](https://www.jbang.dev) lets you run or install bacon directly from Maven Central with no manual download. Requires Java 17+.
+
+## Run directly
+
+```shell
+jbang bacon@project-ncl pnc build list
+jbang pnc@project-ncl build list
+jbang da@project-ncl
+jbang pig@project-ncl
+```
+
+## Install as a local command
+
+```shell
+jbang app install bacon@project-ncl
+jbang app install pnc@project-ncl
+jbang app install da@project-ncl
+jbang app install pig@project-ncl
+```
+
+After installing, `bacon`, `pnc`, `da`, and `pig` are available on your `PATH`.
+
+## Snapshot builds
+
+Append `-snapshot` to use the latest snapshot from Maven Central:
+
+```shell
+jbang bacon-snapshot@project-ncl pnc build list
+jbang app install bacon-snapshot@project-ncl
+```
+
 ---
 # Reporting an issue
 To report an issue, please use the NCLSUP/NCL projects in the internal JIRA instance. The Github issues usage is now disabled.
diff --git a/jbang-catalog.json b/jbang-catalog.json
new file mode 100644
index 000000000..5d82ed245
--- /dev/null
+++ b/jbang-catalog.json
@@ -0,0 +1,54 @@
+{
+  "aliases": {
+    "bacon": {
+      "script-ref": "org.jboss.pnc.bacon:cli:RELEASE:shaded",
+      "description": "PNC/DA/PiG CLI for ProjectNCL 2.0",
+      "java": "17+"
+    },
+    "pnc": {
+      "script-ref": "org.jboss.pnc.bacon:cli:RELEASE:shaded",
+      "arguments": ["pnc"],
+      "description": "PNC CLI (via bacon)",
+      "java": "17+"
+    },
+    "da": {
+      "script-ref": "org.jboss.pnc.bacon:cli:RELEASE:shaded",
+      "arguments": ["da"],
+      "description": "Dependency Analysis CLI (via bacon)",
+      "java": "17+"
+    },
+    "pig": {
+      "script-ref": "org.jboss.pnc.bacon:cli:RELEASE:shaded",
+      "arguments": ["pig"],
+      "description": "PiG CLI (via bacon)",
+      "java": "17+"
+    },
+    "bacon-snapshot": {
+      "script-ref": "org.jboss.pnc.bacon:cli:LATEST:shaded",
+      "description": "PNC/DA/PiG CLI for ProjectNCL 2.0 (snapshot)",
+      "java": "17+",
+      "repositories": ["mavenlocal", "central", "central-portal-snapshots"]
+    },
+    "pnc-snapshot": {
+      "script-ref": "org.jboss.pnc.bacon:cli:LATEST:shaded",
+      "arguments": ["pnc"],
+      "description": "PNC CLI (via bacon, snapshot)",
+      "java": "17+",
+      "repositories": ["mavenlocal", "central", "central-portal-snapshots"]
+    },
+    "da-snapshot": {
+      "script-ref": "org.jboss.pnc.bacon:cli:LATEST:shaded",
+      "arguments": ["da"],
+      "description": "Dependency Analysis CLI (via bacon, snapshot)",
+      "java": "17+",
+      "repositories": ["mavenlocal", "central", "central-portal-snapshots"]
+    },
+    "pig-snapshot": {
+      "script-ref": "org.jboss.pnc.bacon:cli:LATEST:shaded",
+      "arguments": ["pig"],
+      "description": "PiG CLI (via bacon, snapshot)",
+      "java": "17+",
+      "repositories": ["mavenlocal", "central", "central-portal-snapshots"]
+    }
+  }
+}