docs(readme): improve formatting of Installation section

Should fix startup error about missing *.eln files.

.github/workflows/build.yml

@@ -10,23 +10,23 @@ on:
         required: true
         default: "master"
       extraPlanArgs:
-        Description: "Extra plan args"
+        description: "Extra plan args"
         required: false
         default: ""
       extraCheckArgs:
-        Description: "Extra check args"
+        description: "Extra check args"
         required: false
         default: ""
       extraBuildArgs:
-        Description: "Extra build args"
+        description: "Extra build args"
         required: false
         default: ""
       extraPackageArgs:
-        Description: "Extra package args"
+        description: "Extra package args"
         required: false
         default: ""
       extraReleaseArgs:
-        Description: "Extra release args"
+        description: "Extra release args"
         required: false
         default: ""
 
@@ -40,11 +40,17 @@ jobs:
         uses: actions/checkout@v2
         with:
           repository: jimeh/build-emacs-for-macos
-          ref: "v0.5.0"
+          ref: "v0.6.2"
           path: builder
       - uses: actions/setup-go@v2
         with:
           go-version: 1.16
+      - uses: actions/cache@v2
+        id: builder-cache
+        with:
+          path: ~/go/pkg/mod
+          key: ${{ runner.os }}-go-${{ hashFiles('builder/**/go.sum') }}
+          restore-keys: ${{ runner.os }}-go-
       - name: Pre-build emacs-builder tool
         run: make build
         working-directory: builder
@@ -90,7 +96,7 @@ jobs:
         uses: actions/checkout@v2
         with:
           repository: jimeh/build-emacs-for-macos
-          ref: "v0.5.0"
+          ref: "v0.6.2"
           path: builder
       - uses: ruby/setup-ruby@v1
         with:

.github/workflows/dispatch-cask-update.yml

@@ -0,0 +1,15 @@
+---
+name: Dispatch Cask Update
+on:
+  release:
+    types: [published]
+
+jobs:
+  dispatch-cask-update:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Run update formulas workflow in jimeh/homebrew-emacs-builds
+        run: >-
+          gh workflow run --repo jimeh/homebrew-emacs-builds update-formulas.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.TAP_REPO_TOKEN }}

.github/workflows/test-build.yml

@@ -19,23 +19,23 @@ on:
         required: true
         default: "prerelease"
       extraPlanArgs:
-        Description: "Extra plan args"
+        description: "Extra plan args"
         required: false
         default: ""
       extraCheckArgs:
-        Description: "Extra check args"
+        description: "Extra check args"
         required: false
         default: ""
       extraBuildArgs:
-        Description: "Extra build args"
+        description: "Extra build args"
         required: false
         default: ""
       extraPackageArgs:
-        Description: "Extra package args"
+        description: "Extra package args"
         required: false
         default: ""
       extraReleaseArgs:
-        Description: "Extra release args"
+        description: "Extra release args"
         required: false
         default: ""
 
@@ -54,6 +54,12 @@ jobs:
       - uses: actions/setup-go@v2
         with:
           go-version: 1.16
+      - uses: actions/cache@v2
+        id: builder-cache
+        with:
+          path: ~/go/pkg/mod
+          key: ${{ runner.os }}-go-${{ hashFiles('builder/**/go.sum') }}
+          restore-keys: ${{ runner.os }}-go-
       - name: Pre-build emacs-builder tool
         run: make build
         working-directory: builder

README.md

@@ -61,7 +61,9 @@
 
 - Intel-based Mac running macOS 10.15.x or later.
 
-## Downloads
+## Installation
+
+### Manual Download
 
 See the [Releases][] page to download latest builds.
 
@@ -73,8 +75,39 @@ any issues.
 [releases]: https://github.com/jimeh/emacs-builds/releases
 [7]: https://github.com/jimeh/emacs-builds/issues/7
 
+### Homebrew Cask
+
+1. Install the `jimeh/emacs-builds` Homebrew tap:
+   ```
+   brew tap jimeh/emacs-builds
+   ```
+2. Install one of the available casks:
+   - `emacs-app-nightly` for the latest nightly build:
+     ```
+     brew install --cask emacs-app-nightly
+     ```
+   - `emacs-app-good` for the latest known good nightly build listed on [#7][7]:
+     ```
+     brew install --cask emacs-app-good
+     ```
+
+[7]: https://github.com/jimeh/emacs-builds/issues/7
+
 ## Use Emacs.app as `emacs` CLI Tool
 
+### Installed via Homebrew Cask
+
+The cask installation method sets up CLI usage automatically by exposing a
+`emacs` command. However it will launch Emacs into GUI mode. To instead have
+`emacs` in your terminal open a terminal instance of Emacs, add the following
+alias to your shell setup:
+
+```bash
+alias emacs="emacs -nw"
+```
+
+### Installed Manually
+
 Builds come with a custom `emacs` shell script launcher for use from the command
 line, located next to `emacsclient` in `Emacs.app/Contents/MacOS/bin`.