Skip to content
Agent Browser Gateway Docs

Distribution

ABG release artifacts are built from the repository and published for the app, CLI, and browser extension. The public download page keeps current artifacts available under /downloads/.

Homebrew cask

Section titled “Homebrew cask”

The macOS cask installs:

  • Agent Browser Gateway.app into /Applications
  • abg into Homebrew’s bin

Install test:

Terminal window
brew tap arcmanagement/agent-browser-gateway https://github.com/arcmanagement/agent-browser-gateway
brew trust --cask arcmanagement/agent-browser-gateway/agent-browser-gateway
brew install --cask agent-browser-gateway

If Homebrew reports that the latest version is already installed, the cask install path is working and no update is needed.

Homebrew is ready for a release when the versioned macOS ZIP is published under https://agent-browser-gateway.com/downloads/, and this repository’s Casks/agent-browser-gateway.rb points at that version and SHA-256.

WinGet

Section titled “WinGet”

The Windows package identifier is:

Terminal window
winget install --id ArcManagement.AgentBrowserGateway --source winget

Current v0.4.1 status: this package is not indexed yet, and the command above returns no matching package until the signed Windows release workflow and WinGet submission are completed.

WinGet is ready for a release after the public Windows setup ZIP is available under /downloads/ and the generated microsoft/winget-pkgs PR is merged and indexed.

Signed local release build

Section titled “Signed local release build”

Maintainer release builds are created on a trusted Mac:

Terminal window
export VERSION=0.4.1
make dist VERSION="$VERSION" \
  SIGN_IDENTITY="Developer ID Application: ArcManagement Inc (M46W5MVAQP)" \
  NOTARY_PROFILE="abg-notary"

Keep Developer ID signing local. Do not put the Developer ID private key, certificate password, App Store Connect credentials, or notarytool credentials into GitHub Actions secrets.

Verify artifacts

Section titled “Verify artifacts”
Terminal window
codesign --verify --strict --verbose=2 \
  "dist/agent-browser-gateway-$VERSION-macos-arm64/Agent Browser Gateway.app"
codesign --verify --strict --verbose=2 \
  "dist/agent-browser-gateway-$VERSION-macos-arm64/abg"
spctl --assess --type execute --verbose \
  "dist/agent-browser-gateway-$VERSION-macos-arm64/Agent Browser Gateway.app"
shasum -a 256 \
  "dist/agent-browser-gateway-$VERSION-macos-arm64.zip" \
  "dist/agent-browser-gateway-extension-$VERSION.zip"

CI may build and test unsigned artifacts. Signed release assets should be created on a trusted maintainer Mac and published to the public download site afterward.