From a66aee063ce75bf804f5c50ecdf17f7f8b8f20e5 Mon Sep 17 00:00:00 2001 From: Oliver Kopp Date: Mon, 20 Jul 2026 14:23:22 +0200 Subject: [PATCH 1/2] Document JabKit native binary as recommended install method Follows JabRef/jabref#16291, which ships jabkit as a GraalVM native binary in the binary distribution. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01GECSiMgNPPrrFmqCSixkcs --- en/jabkit.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/en/jabkit.md b/en/jabkit.md index 4d830fa28..d593b5b65 100644 --- a/en/jabkit.md +++ b/en/jabkit.md @@ -6,6 +6,33 @@ description: JabKit is JabRef's CLI tool ## Installing and Running +### Native binary (recommended) + +JabKit is available as a native binary for Linux (amd64/arm64) and macOS (Apple Silicon). It is a self-contained executable: no Java runtime is required, and it starts instantly. Download it from the [JabRef builds server](https://builds.jabref.org/main/) and unpack it: + +```bash +# Linux (amd64) +curl -L https://builds.jabref.org/main/linux-amd64/tools/jabkit-native_linux.tar.gz | tar xz +./jabkit/jabkit --help +``` + +```bash +# Linux (arm64) +curl -L https://builds.jabref.org/main/linux-arm/tools/jabkit-native_linux_arm64.tar.gz | tar xz +./jabkit/jabkit --help +``` + +```bash +# macOS (Apple Silicon) +curl -LO https://builds.jabref.org/main/macOS-silicon/tools/jabkit-native_macos-silicon.zip +unzip jabkit-native_macos-silicon.zip +./jabkit/jabkit --help +``` + +On other platforms (e.g. Windows, Intel macOS), use one of the options below. + +### JBang and Docker + The easiest way to run JabKit is using [npx](https://docs.npmjs.com/cli/v8/commands/npx) and [jbang](https://www.jbang.dev/): ```bash From e1acc8bb17ad3d35a1713aedaac17a49f3077f20 Mon Sep 17 00:00:00 2001 From: Oliver Kopp Date: Mon, 20 Jul 2026 15:47:23 +0200 Subject: [PATCH 2/2] Use curl -f so a missing download fails instead of saving an error page Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01GECSiMgNPPrrFmqCSixkcs --- en/jabkit.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/en/jabkit.md b/en/jabkit.md index d593b5b65..1607eea23 100644 --- a/en/jabkit.md +++ b/en/jabkit.md @@ -12,19 +12,19 @@ JabKit is available as a native binary for Linux (amd64/arm64) and macOS (Apple ```bash # Linux (amd64) -curl -L https://builds.jabref.org/main/linux-amd64/tools/jabkit-native_linux.tar.gz | tar xz +curl -fL https://builds.jabref.org/main/linux-amd64/tools/jabkit-native_linux.tar.gz | tar xz ./jabkit/jabkit --help ``` ```bash # Linux (arm64) -curl -L https://builds.jabref.org/main/linux-arm/tools/jabkit-native_linux_arm64.tar.gz | tar xz +curl -fL https://builds.jabref.org/main/linux-arm/tools/jabkit-native_linux_arm64.tar.gz | tar xz ./jabkit/jabkit --help ``` ```bash # macOS (Apple Silicon) -curl -LO https://builds.jabref.org/main/macOS-silicon/tools/jabkit-native_macos-silicon.zip +curl -fLO https://builds.jabref.org/main/macOS-silicon/tools/jabkit-native_macos-silicon.zip unzip jabkit-native_macos-silicon.zip ./jabkit/jabkit --help ```