From 1a2c9d00b2f6e2cc9b96996b87cd410699d62c97 Mon Sep 17 00:00:00 2001 From: Julien Danjou Date: Fri, 10 Apr 2026 10:56:20 +0200 Subject: [PATCH] docs: add CLI pause/unpause commands to pause page Add mergify queue pause and unpause CLI commands to the existing pause page alongside the dashboard and API methods. Co-Authored-By: Claude Opus 4.6 (1M context) Change-Id: Ifa35994d9dcaa28877b61ef67912f65abee81caf Claude-Session-Id: a911b6ad-5466-48a4-b4d3-85198ebc7c28 --- src/content/docs/cli.mdx | 2 +- src/content/docs/merge-queue/pause.mdx | 14 ++++++++++++++ 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/src/content/docs/cli.mdx b/src/content/docs/cli.mdx index 42e7ad36d5..5b249e1305 100644 --- a/src/content/docs/cli.mdx +++ b/src/content/docs/cli.mdx @@ -64,6 +64,6 @@ mergify --token your_token_here |---|---|---| | `mergify stack` | Create and manage stacked pull requests | [Stacks](/stacks) | | `mergify freeze` | Schedule and manage merge freezes | [Scheduling Freezes](/merge-protections/freeze) | -| `mergify queue` | Monitor merge queue status | [Monitoring](/merge-queue/monitoring) | +| `mergify queue` | Monitor and control merge queue | [Monitoring](/merge-queue/monitoring) | | `mergify config` | Validate and simulate config | [Config](/configuration/file-format#validating-with-the-cli) | | `mergify ci` | Upload and analyze CI results | [CI Insights](/ci-insights) | diff --git a/src/content/docs/merge-queue/pause.mdx b/src/content/docs/merge-queue/pause.mdx index 3faf55f911..2088ddc86a 100644 --- a/src/content/docs/merge-queue/pause.mdx +++ b/src/content/docs/merge-queue/pause.mdx @@ -46,6 +46,20 @@ the queue. Pause button is in the top right corner in Mergify's dashboard +### Using the CLI + +Pause the queue from the terminal with an optional reason: + +```bash +mergify queue pause --reason "deploying hotfix" +``` + +Resume when ready: + +```bash +mergify queue unpause +``` + ### Using the API You can also pause the merge queue programmatically using the [Mergify