Release builds of oh for Linux, macOS and Windows 99ca93d60bca

OxygenHub (the hub, oh and hub-api) is licensed under either of

  * the MIT License (below), or

  * the Apache License, Version 2.0 (https://www.apache.org/licenses/LICENSE-2.0)

at your option.

---

MIT License

Copyright (c) 2026 Andy McCall

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all

copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

SOFTWARE.

#!/usr/bin/env bash

# Build release archives of one binary for every platform from Linux:

#   Linux x86_64 and arm64 (glibc 2.28 and later): .tar.gz and .deb

#   macOS x86_64 and arm64: .tar.gz

#   Windows x86_64: .zip

# plus SHA256SUMS, in target/dist/VERSION.

#

#   scripts/dist.sh [VERSION]    (default: the package version)

#

# Needs: rustup targets x86_64-pc-windows-gnu, aarch64-unknown-linux-gnu,

# x86_64-apple-darwin and aarch64-apple-darwin; cargo-zigbuild and zig on

# PATH (Linux with an old glibc, and macOS without Apple's SDK); the

# MinGW-w64 gcc (Windows); dpkg-deb and zip.

set -euo pipefail

PKG=oh                   # the cargo package

BIN=oh                   # the binary it builds

DEB_NAME=oh              # the Debian package

SUMMARY="OxygenHub from the command line"

DESCRIPTION="oh talks to an OxygenHub (such as https://oxygenhub.io): issues,

 proposals and their reviews, releases, Flow runs and checks, from the

 terminal. It works alongside oxy, the Oxygen version control client."

HOMEPAGE="https://oxygenhub.io/andymccall/oxygenhub"

MAINTAINER="Andy McCall <[email protected]>"

DOCS=(README.md LICENSE docs/oh.md)

cd "$(dirname "$0")/.."

VERSION="${1:-$(cargo metadata --no-deps --format-version 1 | python3 -c "import json,sys; print(next(p['version'] for p in json.load(sys.stdin)['packages'] if p['name']=='$PKG'))")}"

VERSION="${VERSION#v}"

OUT="target/dist/$VERSION"

rm -rf "$OUT" && mkdir -p "$OUT"

export PATH="$HOME/.local/opt/zig:$PATH"

# Stripped, with no debug info: these are for people, not for debugging.

export CARGO_PROFILE_RELEASE_DEBUG=0 CARGO_PROFILE_RELEASE_STRIP=true CARGO_INCREMENTAL=0

# The version the binary reports.

export OXY_BUILD="v$VERSION"

# target triple | platform name | build tool | Debian architecture

PLATFORMS=(

  "x86_64-unknown-linux-gnu.2.28|linux-x86_64|zig|amd64"

  "aarch64-unknown-linux-gnu.2.28|linux-arm64|zig|arm64"

  "x86_64-apple-darwin|macos-x86_64|zig|"

  "aarch64-apple-darwin|macos-arm64|zig|"

  "x86_64-pc-windows-gnu|windows-x86_64|cargo|"

)

for p in "${PLATFORMS[@]}"; do

  IFS='|' read -r target platform tool deb <<<"$p"

  triple="${target%%.2.*}"

  echo "== $platform ($target)"

  if [ "$tool" = zig ]; then

    cargo zigbuild -q --release --locked --target "$target" -p "$PKG"

  else

    cargo build -q --release --locked --target "$target" -p "$PKG"

  fi

  exe="$BIN"

  [[ "$triple" == *windows* ]] && exe="$BIN.exe"

  built="target/$triple/release/$exe"

  name="$BIN-$VERSION-$platform"

  stage="$OUT/stage/$name"

  mkdir -p "$stage"

  cp "$built" "$stage/"

  cp "${DOCS[@]}" "$stage/"

  if [[ "$triple" == *windows* ]]; then

    (cd "$OUT/stage" && zip -qr "../$name.zip" "$name")

  else

    tar -C "$OUT/stage" -czf "$OUT/$name.tar.gz" "$name"

  fi

  if [ -n "$deb" ]; then

    root="$OUT/stage/deb-$deb"

    mkdir -p "$root/DEBIAN" "$root/usr/bin" "$root/usr/share/doc/$DEB_NAME"

    install -m 0755 "$built" "$root/usr/bin/$BIN"

    cp README.md docs/oh.md "$root/usr/share/doc/$DEB_NAME/"

    cp LICENSE "$root/usr/share/doc/$DEB_NAME/copyright"

    cat >"$root/DEBIAN/control" <<EOF

Package: $DEB_NAME

Version: $VERSION

Architecture: $deb

Maintainer: $MAINTAINER

Depends: libc6 (>= 2.28)

Section: vcs

Priority: optional

Homepage: $HOMEPAGE

Installed-Size: $(du -sk "$root/usr" | cut -f1)

Description: $SUMMARY

 $DESCRIPTION

EOF

    dpkg-deb --build --root-owner-group -Zxz "$root" "$OUT/${DEB_NAME}_${VERSION}_$deb.deb" >/dev/null

  fi

done

rm -rf "$OUT/stage"

(cd "$OUT" && sha256sum -- *.tar.gz *.zip *.deb >SHA256SUMS)

echo "== $OUT"

ls -l "$OUT"

## Install oh

Builds for Linux, macOS and Windows are on the [releases page](https://oxygenhub.io/andymccall/oxygenhub/releases). These are early releases: the macOS and Windows builds are not signed and have had little testing.

- **Debian, Ubuntu and other Linux with apt** (x86_64 or arm64): download `oh_VERSION_amd64.deb` (or `_arm64.deb`) and run `sudo apt install ./oh_VERSION_amd64.deb`. It needs glibc 2.28 or later (Debian 10, Ubuntu 20.04 and newer).

- **Other Linux:** unpack `oh-VERSION-linux-x86_64.tar.gz` (or `-linux-arm64`) and put `oh` on your `PATH`.

- **macOS** (Apple Silicon or Intel): unpack `oh-VERSION-macos-arm64.tar.gz` (or `-macos-x86_64`), then `xattr -d com.apple.quarantine oh`, since the build is not notarised, and put it on your `PATH`.

- **Windows:** unzip `oh-VERSION-windows-x86_64.zip` and put the folder on your `PATH`. SmartScreen may warn on first run, since the build is not signed.

Sign in with `oh auth login --with-hub https://oxygenhub.io`; the commands are in `docs/oh.md`. `oh` works alongside `oxy`, from [Oxygen's releases](https://oxygenhub.io/andymccall/oxygen/releases).

Check a download against the release's `SHA256SUMS` with `sha256sum -c SHA256SUMS --ignore-missing`.