Skip to content

docs(readme): recommend the Homebrew tap as the primary install method#1627

Merged
mergify[bot] merged 3 commits into
mainfrom
devs/kozlek/readme-homebrew-recommended
Jun 17, 2026
Merged

docs(readme): recommend the Homebrew tap as the primary install method#1627
mergify[bot] merged 3 commits into
mainfrom
devs/kozlek/readme-homebrew-recommended

Conversation

@kozlek

@kozlek kozlek commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Promote brew install mergifyio/tap/mergify-cli to the top of the README's Installation section as the recommended route for macOS.

What changed

  • Restructured the Installation section into three labelled methods, ranked:
    1. Homebrew (recommended for macOS)brew install mergifyio/tap/mergify-cli, links to the tap for tap-trust / short-name details
    2. Install script (recommended for Linux; also macOS) → unchanged curl … | sh
    3. Manual download (Windows, or to bypass the script) → unchanged archive instructions
  • Made upgrade guidance method-specific: Homebrew installs upgrade with brew upgrade mergify-cli, not mergify self-update (which overwrites the brew-managed binary). The previous README told every install to use mergify self-update.

Windows stays on the manual download since the tap doesn't ship a Windows formula.

🤖 Generated with Claude Code

Promote `brew install mergifyio/tap/mergify-cli` to the top of the
Installation section as the recommended route, ahead of the install
script and manual archive download. Restructure the section into three
labelled methods and make the upgrade guidance method-specific: Homebrew
installs upgrade with `brew upgrade` (never `mergify self-update`, which
clobbers the brew-managed binary), while script installs keep using
`mergify self-update`.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: If23618943da64d2f67f88259b8a688e5def642bd
Copilot AI review requested due to automatic review settings June 17, 2026 09:56
@mergify mergify Bot had a problem deploying to Mergify Merge Protections June 17, 2026 09:56 Failure
@kozlek kozlek temporarily deployed to func-tests-live June 17, 2026 09:57 — with GitHub Actions Inactive
@mergify

mergify Bot commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Merge Protections

🟢 All 5 merge protections satisfied — ready to merge.

…inux

Scope the Homebrew recommendation to macOS and mark the install script
as the recommended route for Linux (it still works on macOS too).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: I155321d6d57ab6d16dd412364bd4248643f7862a

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the README installation guidance to recommend installing Mergify CLI via the official Homebrew tap first, and adjusts upgrade instructions to be method-specific (notably avoiding mergify self-update for Homebrew installs).

Changes:

  • Promote brew install mergifyio/tap/mergify-cli as the primary (recommended) install path for macOS + Linux.
  • Clarify that Homebrew installs should be upgraded via brew upgrade mergify-cli (not mergify self-update).
  • Reframe the remaining install options into explicit “Install script” and “Manual download” methods.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
@kozlek kozlek temporarily deployed to func-tests-live June 17, 2026 09:58 — with GitHub Actions Inactive
@mergify mergify Bot had a problem deploying to Mergify Merge Protections June 17, 2026 09:59 Failure
A concrete pinned version in the install-script example goes stale and
invites copy/paste of an outdated release. Use `<version>` to match the
placeholder style of the manual-download section.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: Ib2e088418d225f479fe1a081045accfb87211e48
@kozlek kozlek temporarily deployed to func-tests-live June 17, 2026 10:05 — with GitHub Actions Inactive
@mergify mergify Bot deployed to Mergify Merge Protections June 17, 2026 10:05 Active
@kozlek kozlek requested a review from a team June 17, 2026 10:09
@mergify

mergify Bot commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Queued — the merge queue status continues in this comment ↓.

@mergify

mergify Bot commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Merge Queue Status

This pull request spent 8 minutes 59 seconds in the queue, including 7 minutes 52 seconds running CI.

Required conditions to merge

mergify Bot added a commit that referenced this pull request Jun 17, 2026
@mergify mergify Bot added the queued label Jun 17, 2026
@mergify mergify Bot merged commit f279feb into main Jun 17, 2026
18 checks passed
@mergify mergify Bot deleted the devs/kozlek/readme-homebrew-recommended branch June 17, 2026 12:20
@mergify mergify Bot removed the queued label Jun 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

4 participants