https://github.com/noclaps/homebrew-tap-action

A GitHub Action to push updates to a Homebrew tap
https://github.com/noclaps/homebrew-tap-action

Last synced: about 1 year ago
JSON representation

A GitHub Action to push updates to a Homebrew tap

• Host: GitHub
• URL: https://github.com/noclaps/homebrew-tap-action
• Owner: noClaps
• License: 0bsd
• Created: 2025-06-01T13:50:53.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-16T13:40:07.000Z (about 1 year ago)
• Last Synced: 2025-06-19T02:11:42.844Z (about 1 year ago)
• Homepage:
• Size: 12.7 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# homebrew-tap-action

A GitHub Action to push updates to a Homebrew tap

## Usage

Create a fine-grained token for your Homebrew tap repository, with read and write permssions for Content. Set it as `HOMEBREW_TAP_TOKEN` in your repository's actions secrets.

In your build workflow, put your output binary files into `tar.gz` archives, with the following structure:

```

my-tool-macos-arm64.tar.gz

└── my-tool-macos-arm64

my-tool-linux.tar.gz

└── my-tool-linux

```

You can then use the workflow with:

```yaml

- name: Update Homebrew Tap

  uses: noClaps/homebrew-tap-action@v1

  with:

    tap_repo: 'your-username/homebrew-tap'

    formula_name: 'my-tool'

    version: ${{ github.event.release.tag_name }}

    tap_token: ${{ secrets.HOMEBREW_TAP_TOKEN }}

    macos_file: 'my-tool-macos-arm64.tar.gz'

    linux_file: 'my-tool-linux.tar.gz'

```

When the workflow finishes running, you should have an updated file in your `homebrew-tap/Formula/my-tool.rb` file.