mergify-cli 2026.6.18.1

Mergify CLI is a tool that automates the creation and management of stacked pull requests on GitHub and handles CI results upload

Mergify CLI

Command-line tool for Mergify: stacked pull requests, CI insights, merge queue, scheduled freezes, and configuration management.

Installation

Homebrew (recommended for macOS)

brew install mergifyio/tap/mergify-cli

The fully-qualified name taps and installs in one step. Upgrade with brew upgrade mergify-cli — not mergify self-update, which overwrites the Homebrew-managed binary. See the tap for tap-trust and short-name details.

Install script (recommended for Linux; also macOS — x86_64 and aarch64)

curl -fsSL https://raw.githubusercontent.com/Mergifyio/mergify-cli/main/install.sh | sh

Installs to ~/.local/bin/mergify. Override with MERGIFY_INSTALL_DIR=/usr/local/bin or pin a version with MERGIFY_VERSION=<version>. Upgrade with mergify self-update.

Manual download (Windows, or to bypass the script)

Grab the matching archive from the latest release:

• Windows — download mergify-<version>-x86_64-pc-windows-msvc.zip, extract it, and put mergify.exe anywhere on your PATH.
• Linux / macOS — download mergify-<version>-<target>.tar.gz (e.g. mergify-2026.4.23.1-aarch64-apple-darwin.tar.gz), extract with tar -xzf, and put the resulting mergify binary anywhere on your PATH.

Verify against SHA256SUMS from the same release if you care.

Run mergify --help to list commands and mergify <command> --help for details. See the CLI docs for authentication and global options (--token, --repository, --api-url).

Commands

• mergify stack — Create and manage stacked pull requests. Docs
• mergify ci — Upload JUnit results, evaluate quarantine, detect git refs and CI scopes. Docs
• mergify tests — Inspect test health and manage quarantine for tests tracked by Mergify CI Insights (mergify tests show NAME..., mergify tests quarantines add NAME, mergify tests quarantines remove NAME). Docs
• mergify queue — Monitor and manage the Mergify merge queue. Docs
• mergify freeze — Create and manage scheduled merge freezes. Docs
• mergify config — Validate and simulate Mergify configuration. Docs

AI Agent Skills

Mergify CLI provides AI skills for managing stacked PRs and Git workflows, compatible with Claude Code, Cursor, and many other AI agents.

Install via npx (all agents):

npx skills add Mergifyio/mergify-cli

Install as a Claude Code plugin:

/plugin marketplace add Mergifyio/mergify-cli
/plugin install mergify

Contributing

Contributions are welcome — open an issue or pull request.

License

Apache License 2.0 — see LICENSE.