How Hermes Chrome ships the companion (machine half) and related installers.
| Channel | Purpose |
|---|---|
| Chrome Web Store | Extension only (browser half) |
GitHub Release (v* tag) |
Companion tarball, extension zip, install.sh, optional .pkg |
| curl one-liner | scripts/install.sh from main or release asset |
npm hermes-chrome-companion |
Thin npx wrapper that runs GitHub install scripts |
| macOS .pkg | GUI installer wrapping the same companion tree |
| macOS wizard | scripts/packaging/macos-install-wizard.command (double-click) |
Not shipped as: PyPI package, full Node rewrite, remote cloud bridge.
| Path | Role |
|---|---|
~/.hermes/hermes-chrome |
Install root (code) |
~/.hermes/run/hermes-chrome |
Runtime (token, logs, native host) |
~/.local/bin/hermes-chrome |
CLI shim |
# Ensure extension/manifest.json version matches the tag
# e.g. version 1.8.0 → tag v1.8.0
git tag v1.8.0
git push origin v1.8.0
CI (tests + CodeQL, no Chrome): .github/workflows/ci.yml · local: ./scripts/ci-check.sh
Workflow: .github/workflows/release.yml
dist/release/* via scripts/packaging/build-release-assets.sh.pkg via scripts/packaging/build-macos-pkg.sh (unsigned unless secrets set)| Secret | Use |
|---|---|
HERMES_CHROME_SIGN_IDENTITY |
productsign identity, e.g. Developer ID Installer: … |
HERMES_CHROME_NOTARY_PROFILE |
xcrun notarytool keychain profile name |
Without secrets the .pkg is unsigned (users: right-click → Open).
# Release assets (tarball + extension zip + checksums)
./scripts/packaging/build-release-assets.sh
# macOS package
./scripts/packaging/build-macos-pkg.sh
# optional:
# HERMES_CHROME_SIGN_IDENTITY="Developer ID Installer: …" ./scripts/packaging/build-macos-pkg.sh
# Double-click wizard (from Finder)
open scripts/packaging/macos-install-wizard.command
npx hermes-chrome-companion install
Package lives in npm/. It only downloads/runs install scripts — it does not embed the bridge.
Publish:
cd npm && npm publish --access public
No signed MSI in-tree yet. Use:
powershell -ExecutionPolicy Bypass -File .\scripts\install-windows.ps1
or download install-windows.ps1 from the GitHub Release.
./store/package.sh
# → store/dist/hermes-chrome-v<ver>.zip