From 4f39217945e33ac9c3249ea03acd11c1fd020749 Mon Sep 17 00:00:00 2001
From: Julien Danjou <julien@danjou.info>
Date: Mon, 15 Jun 2026 17:59:45 +0200
Subject: [PATCH] docs: install the CLI via the install script

Switch the documented install method to the standard one-line installer
(`curl -fsSL https://raw.githubusercontent.com/Mergifyio/mergify-cli/main/install.sh | sh`)
and drop the uv/pipx/Homebrew alternatives. Updates the CLI page, the
shared stacks install partials, the agents bootstrap, and the gh-stack
distribution note.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: I0a67ad63cdb6eff97e561cb0bee68f4ef96a1f5f
---
 src/content/docs/cli.mdx                     | 20 ++++++++++----------
 src/content/docs/stacks/_install-setup.mdx   |  2 +-
 src/content/docs/stacks/_install.mdx         |  2 +-
 src/content/docs/stacks/_quickstart.mdx      |  2 +-
 src/content/docs/stacks/agents.mdx           |  6 +-----
 src/content/docs/stacks/compare/gh-stack.mdx |  2 +-
 6 files changed, 15 insertions(+), 19 deletions(-)

diff --git a/src/content/docs/cli.mdx b/src/content/docs/cli.mdx
index 692ea2a985..7f044d44e0 100644
--- a/src/content/docs/cli.mdx
+++ b/src/content/docs/cli.mdx
@@ -8,25 +8,25 @@ terminal.
 
 ## Installation
 
-Install the CLI using [uv](https://docs.astral.sh/uv/):
+Install the CLI with the install script:
 
 ```bash
-uv tool install mergify-cli
+curl -fsSL https://raw.githubusercontent.com/Mergifyio/mergify-cli/main/install.sh | sh
 ```
 
-Or using [pipx](https://pipx.pypa.io/):
+## Updating
 
-```bash
-pipx install mergify-cli
-```
-
-On macOS, you can install these tools via Homebrew:
+Update an existing install to the latest release in place:
 
 ```bash
-brew install uv
-uv tool install mergify-cli
+mergify self-update
 ```
 
+This downloads the latest binary, verifies it against the published
+`SHA256SUMS`, and swaps it in. Pass `--check` to print your current and the
+latest version without changing anything, or `--force` to reinstall the current
+version (useful for repairing a broken install).
+
 ## Authentication
 
 The CLI needs an authentication token to interact with your repositories.
diff --git a/src/content/docs/stacks/_install-setup.mdx b/src/content/docs/stacks/_install-setup.mdx
index 9710314bdd..be530ed5e0 100644
--- a/src/content/docs/stacks/_install-setup.mdx
+++ b/src/content/docs/stacks/_install-setup.mdx
@@ -1,4 +1,4 @@
 ```bash
-uv tool install mergify-cli
+curl -fsSL https://raw.githubusercontent.com/Mergifyio/mergify-cli/main/install.sh | sh
 mergify stack setup
 ```
diff --git a/src/content/docs/stacks/_install.mdx b/src/content/docs/stacks/_install.mdx
index 04312c3774..9938141df0 100644
--- a/src/content/docs/stacks/_install.mdx
+++ b/src/content/docs/stacks/_install.mdx
@@ -1,3 +1,3 @@
 ```bash
-uv tool install mergify-cli
+curl -fsSL https://raw.githubusercontent.com/Mergifyio/mergify-cli/main/install.sh | sh
 ```
diff --git a/src/content/docs/stacks/_quickstart.mdx b/src/content/docs/stacks/_quickstart.mdx
index c3813893ff..c5aafb148b 100644
--- a/src/content/docs/stacks/_quickstart.mdx
+++ b/src/content/docs/stacks/_quickstart.mdx
@@ -1,5 +1,5 @@
 ```bash
-uv tool install mergify-cli
+curl -fsSL https://raw.githubusercontent.com/Mergifyio/mergify-cli/main/install.sh | sh
 mergify stack setup
 mergify stack push
 ```
diff --git a/src/content/docs/stacks/agents.mdx b/src/content/docs/stacks/agents.mdx
index c4f9f71c86..f52e67f448 100644
--- a/src/content/docs/stacks/agents.mdx
+++ b/src/content/docs/stacks/agents.mdx
@@ -11,14 +11,10 @@ import Install from './_install.mdx';
 
 ## 1. Install the Mergify CLI
 
-Install `mergify-cli` with `uv` (preferred) or `pipx`:
+Install `mergify-cli` with the install script:
 
 <Install />
 
-```bash
-pipx install mergify-cli
-```
-
 Verify:
 
 ```bash
diff --git a/src/content/docs/stacks/compare/gh-stack.mdx b/src/content/docs/stacks/compare/gh-stack.mdx
index 9968d3c811..7a20a3e3f1 100644
--- a/src/content/docs/stacks/compare/gh-stack.mdx
+++ b/src/content/docs/stacks/compare/gh-stack.mdx
@@ -135,7 +135,7 @@ platform.
 
 **Distribution.** gh-stack ships as a `gh` CLI extension and will likely get
 deeper GitHub integration over time. Mergify CLI is a standalone install
-(`uv tool install mergify-cli`).
+(a one-line `curl … | sh`).
 
 **Pricing.** Both are free. Mergify Stacks is a standalone CLI that doesn't
 require a Mergify subscription.