d21879b · diagonal · git.iko.soy

git.iko.soy/diagonal

on master help sign in

Add Homebrew install: fixed-name release asset and README steps

d21879bClaude3 weeks ago

.github/workflows/release.yml+6−3

compare with master

unifiedsplit

@@ -46,6 +46,9 @@ jobs:

46 run: |

47 npm run build

48 (cd dist && zip -qr "../diagonal-extension-${DIAGONAL_VERSION}.zip" .)

49+ # Same zip under a fixed name: releases/latest/download/diagonal-extension.zip is what the

50+ # Homebrew cask (iko-soy/homebrew-tap, Casks/diagonal.rb) downloads.

51+ cp "diagonal-extension-${DIAGONAL_VERSION}.zip" diagonal-extension.zip

49 cat dist/manifest.json | head -5

52 cat dist/manifest.json | head -5

51 - name: Publish release

54 - name: Publish release

@@ -54,10 +57,10 @@ jobs:

54 VERSION: ${{ steps.version.outputs.version }}

57 VERSION: ${{ steps.version.outputs.version }}

55 run: |

58 run: |

56 asset="diagonal-extension-${VERSION}.zip"

59 asset="diagonal-extension-${VERSION}.zip"

57− notes="Built from ${GITHUB_SHA::7}. Unzip, load the folder at brave://extensions (Developer mode → Load unpacked), then install the native host once from Terminal: bash <that folder>/install-host.command"

60+ notes="Built from ${GITHUB_SHA::7}. Install with: brew install iko-soy/tap/diagonal. Or by hand: unzip, load the folder at brave://extensions (Developer mode → Load unpacked), then install the native host once from Terminal: bash <that folder>/install-host.command"

58 if gh release view "$VERSION" >/dev/null 2>&1; then

61 if gh release view "$VERSION" >/dev/null 2>&1; then

59 # Two commits in the same minute share a version: refresh the asset on the existing release.

62 # Two commits in the same minute share a version: refresh the asset on the existing release.

60− gh release upload "$VERSION" "$asset" --clobber

63+ gh release upload "$VERSION" "$asset" diagonal-extension.zip --clobber

61 else

64 else

62− gh release create "$VERSION" "$asset" --target "$GITHUB_SHA" --title "Diagonal $VERSION" --notes "$notes"

65+ gh release create "$VERSION" "$asset" diagonal-extension.zip --target "$GITHUB_SHA" --title "Diagonal $VERSION" --notes "$notes" --latest

63 fi

66 fi

README.md+17−1

@@ -22,7 +22,23 @@ The model sees a tab's title, address and `<meta name="description">`, and nothi

23## Install

25+### With Homebrew

26+

27+```sh

28+brew install iko-soy/tap/diagonal

29+```

30+

31+This downloads the latest release, puts the extension at `~/Library/Application Support/Diagonal/extension`, and installs the native host and registers it with Brave. Then load the extension in Brave once:

32+

33+1. Open `brave://extensions` and turn on **Developer mode**.

34+2. Click **Load unpacked**, press **Cmd+Shift+G** and paste `~/Library/Application Support/Diagonal/extension`.

35+3. Open Diagonal's settings and click **Run self-test**.

36+

37+To update: `brew upgrade --cask --greedy diagonal`, then click reload on Diagonal at `brave://extensions`. `brew uninstall diagonal` removes the extension folder, the host and its Brave manifest; `brew uninstall --zap diagonal` also removes the fm schemas and logs.

38+

39+Brave only installs extensions on its own from the Chrome Web Store, so the one Load unpacked step stays until Diagonal is published there.

40+

25−### From a release (no clone needed)

41+### From a release zip

271. Download `diagonal-extension-<version>.zip` from the [latest release](https://github.com/iko-soy/diagonal/releases/latest) and unzip it somewhere it can stay, for example `~/Applications/Diagonal`.

431. Download `diagonal-extension-<version>.zip` from the [latest release](https://github.com/iko-soy/diagonal/releases/latest) and unzip it somewhere it can stay, for example `~/Applications/Diagonal`.

282. Open `brave://extensions`, turn on **Developer mode**, click **Load unpacked** and pick that folder.

442. Open `brave://extensions`, turn on **Developer mode**, click **Load unpacked** and pick that folder.