From 1a2c9d00b2f6e2cc9b96996b87cd410699d62c97 Mon Sep 17 00:00:00 2001 From: Julien Danjou Date: Fri, 10 Apr 2026 10:56:20 +0200 Subject: [PATCH 1/2] 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 From 10917dd4038706e8d3a967ee05aa79b4bc352776 Mon Sep 17 00:00:00 2001 From: Julien Danjou Date: Fri, 10 Apr 2026 17:19:22 +0200 Subject: [PATCH 2/2] docs(stacks): add Claude Code plugin install commands to setup page Add slash commands for installing the Mergify Stacks skill separately via the Claude Code plugin marketplace. Co-Authored-By: Claude Opus 4.6 (1M context) Change-Id: I6533937e6b7fd52612f9d9d7b377bee3280ea69d Claude-Session-Id: 533eea3a-139d-47ee-a67c-fba178444733 --- src/content/docs/stacks/setup.mdx | 33 ++++++++++++++++++++++++++++--- 1 file changed, 30 insertions(+), 3 deletions(-) diff --git a/src/content/docs/stacks/setup.mdx b/src/content/docs/stacks/setup.mdx index d1dd3ef865..1a9999ead2 100644 --- a/src/content/docs/stacks/setup.mdx +++ b/src/content/docs/stacks/setup.mdx @@ -40,9 +40,36 @@ This installs: - A `pre-push` hook that warns you if you accidentally use `git push` instead of `mergify stack push`. -- A [Claude Code](https://claude.ai/code) skill that teaches the AI - coding agent how to work with Mergify Stacks, so it automatically uses - `mergify stack push` instead of `git push`. +## AI Agent Skills + +Mergify CLI provides AI skills that teach coding agents how to work with +Stacks — so they automatically use `mergify stack push` instead of `git push`, +amend commits instead of creating fixup commits, and follow stack conventions. + +### Install via npx (all agents) + +This works with [Claude Code](https://claude.ai/code), +[Cursor](https://cursor.sh), and +[many other AI agents](https://skills.sh): + +```bash +npx skills add Mergifyio/mergify-cli +``` + +### Install as a Claude Code plugin + +From the official marketplace: + +```text +/plugin install mergify@claude-plugins-official +``` + +Or from the repository: + +```text +/plugin marketplace add Mergifyio/mergify-cli +/plugin install mergify +``` ## Verify It Works