setup-oh

GitHub Action that installs the OpenHeaders CLI (oh) on a runner.

Everything resolves through the OpenHeaders update feed (updates.openheaders.com): the current release from versions/stable.json, the binary from the release's immutable dl/<tag>/ path, verified against the release's SHA256SUMS.txt. One first-party domain — no GitHub API calls, no rate limits, no token needed.

Usage

steps:
  - uses: OpenHeaders/setup-oh@v1
  - run: oh --version

Pin a release (per-tag download paths are immutable):

  - uses: OpenHeaders/setup-oh@v1
    with:
      version: v2026.8.2

Also install the ohd daemon (Linux and macOS runners):

  - uses: OpenHeaders/setup-oh@v1
    with:
      with-daemon: 'true'
  - run: ohd --version

Inputs

Input	Default	Description
version	latest	Release tag to install (e.g. v2026.8.2), or latest for the current stable release.
with-daemon	false	Also install the ohd daemon binary. Linux and macOS runners only.

Platforms

Linux x64, macOS arm64, and Windows x64 runners. On other architectures the installer fails with a pointer to the Node channel (npm install -g @openheaders/cli).

Windows note

PowerShell aliases oh to its built-in Out-Host cmdlet, so in pwsh run steps call oh.exe. bash and cmd steps can use plain oh.

  - run: oh.exe --version        # pwsh (the Windows default shell)
  - run: oh --version
    shell: bash

License

Apache-2.0