Mergify CLI is a tool that automates the creation and management of stacked pull requests on GitHub and handles CI results upload
Project description
Mergify CLI
Command-line tool for Mergify: stacked pull requests, CI insights, merge queue, scheduled freezes, and configuration management.
Installation
Linux + 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=2026.4.23.1. Once installed, upgrade with
mergify self-update.
For 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 putmergify.exeanywhere on yourPATH. - Linux / macOS — download
mergify-<version>-<target>.tar.gz(e.g.mergify-2026.4.23.1-aarch64-apple-darwin.tar.gz), extract withtar -xzf, and put the resultingmergifybinary anywhere on yourPATH.
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. Docsmergify ci— Upload JUnit results, evaluate quarantine, detect git refs and CI scopes. Docsmergify 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). Docsmergify queue— Monitor and manage the Mergify merge queue. Docsmergify freeze— Create and manage scheduled merge freezes. Docsmergify 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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mergify_cli-2026.6.16.1.tar.gz.
File metadata
- Download URL: mergify_cli-2026.6.16.1.tar.gz
- Upload date:
- Size: 339.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1b737c551ced5aa657534c2ba2f71c8037a8ae64958fc2df279f41f1a0732f30
|
|
| MD5 |
75a5fd8604746caa07c5b4a1b0d19303
|
|
| BLAKE2b-256 |
697534aec52274682b13400f4217eedc228ddf7cf0b9563bd1b12bf7d34807c8
|
Provenance
The following attestation bundles were made for mergify_cli-2026.6.16.1.tar.gz:
Publisher:
release.yml on Mergifyio/mergify-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mergify_cli-2026.6.16.1.tar.gz -
Subject digest:
1b737c551ced5aa657534c2ba2f71c8037a8ae64958fc2df279f41f1a0732f30 - Sigstore transparency entry: 1838734330
- Sigstore integration time:
-
Permalink:
Mergifyio/mergify-cli@9e9cae560dad681e8f498f149587b25e07948d1e -
Branch / Tag:
refs/tags/2026.6.16.1 - Owner: https://github.com/Mergifyio
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9e9cae560dad681e8f498f149587b25e07948d1e -
Trigger Event:
release
-
Statement type:
File details
Details for the file mergify_cli-2026.6.16.1-py3-none-win_amd64.whl.
File metadata
- Download URL: mergify_cli-2026.6.16.1-py3-none-win_amd64.whl
- Upload date:
- Size: 4.9 MB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
167835bb1ae15aa0cd0de70c7084729aa14e30718803f6ba593a442375c606df
|
|
| MD5 |
28495915f2e96c185ecf6bbbbc5a12d6
|
|
| BLAKE2b-256 |
d9e2544a371bf9ef1672c96159182135a0a26b8d36dc89c4af8b54ffb3058d2b
|
Provenance
The following attestation bundles were made for mergify_cli-2026.6.16.1-py3-none-win_amd64.whl:
Publisher:
release.yml on Mergifyio/mergify-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mergify_cli-2026.6.16.1-py3-none-win_amd64.whl -
Subject digest:
167835bb1ae15aa0cd0de70c7084729aa14e30718803f6ba593a442375c606df - Sigstore transparency entry: 1838735368
- Sigstore integration time:
-
Permalink:
Mergifyio/mergify-cli@9e9cae560dad681e8f498f149587b25e07948d1e -
Branch / Tag:
refs/tags/2026.6.16.1 - Owner: https://github.com/Mergifyio
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9e9cae560dad681e8f498f149587b25e07948d1e -
Trigger Event:
release
-
Statement type:
File details
Details for the file mergify_cli-2026.6.16.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: mergify_cli-2026.6.16.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 5.0 MB
- Tags: Python 3, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aafca43a8bf6538910f79f564c48d46834d0eaca6f676f286cd5b1cec268acb8
|
|
| MD5 |
994ed40160c650b8cb4e80102785138a
|
|
| BLAKE2b-256 |
430f1a85991286da570ad0c25644c284a3d097eb502b2273e6bff1e5cb5b4fd8
|
Provenance
The following attestation bundles were made for mergify_cli-2026.6.16.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:
Publisher:
release.yml on Mergifyio/mergify-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mergify_cli-2026.6.16.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl -
Subject digest:
aafca43a8bf6538910f79f564c48d46834d0eaca6f676f286cd5b1cec268acb8 - Sigstore transparency entry: 1838734533
- Sigstore integration time:
-
Permalink:
Mergifyio/mergify-cli@9e9cae560dad681e8f498f149587b25e07948d1e -
Branch / Tag:
refs/tags/2026.6.16.1 - Owner: https://github.com/Mergifyio
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9e9cae560dad681e8f498f149587b25e07948d1e -
Trigger Event:
release
-
Statement type:
File details
Details for the file mergify_cli-2026.6.16.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.
File metadata
- Download URL: mergify_cli-2026.6.16.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Upload date:
- Size: 4.7 MB
- Tags: Python 3, manylinux: glibc 2.17+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9bbf5ba5ab45cc57c087b9b65c21d5084bba1731eb50d309618ea92f3a2cf62b
|
|
| MD5 |
d7fdf38715df6865f4940d373da65625
|
|
| BLAKE2b-256 |
3bf0b21ed98bc13157fc7e8e27f4414f65e7393e9e712faf22c59806262c5eec
|
Provenance
The following attestation bundles were made for mergify_cli-2026.6.16.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:
Publisher:
release.yml on Mergifyio/mergify-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mergify_cli-2026.6.16.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl -
Subject digest:
9bbf5ba5ab45cc57c087b9b65c21d5084bba1731eb50d309618ea92f3a2cf62b - Sigstore transparency entry: 1838734957
- Sigstore integration time:
-
Permalink:
Mergifyio/mergify-cli@9e9cae560dad681e8f498f149587b25e07948d1e -
Branch / Tag:
refs/tags/2026.6.16.1 - Owner: https://github.com/Mergifyio
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9e9cae560dad681e8f498f149587b25e07948d1e -
Trigger Event:
release
-
Statement type:
File details
Details for the file mergify_cli-2026.6.16.1-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: mergify_cli-2026.6.16.1-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 4.7 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d39b4ec51a620414008cc2226d82da66d15d47616ffd3b051b28ddcae8c7da80
|
|
| MD5 |
f303cffbf3dec2dfcabcd10cdb70006a
|
|
| BLAKE2b-256 |
0e4feb6d0a514bd71a92ef81abcf25f9fcfc0992f59fa0c12fa7e629973b50c3
|
Provenance
The following attestation bundles were made for mergify_cli-2026.6.16.1-py3-none-macosx_11_0_arm64.whl:
Publisher:
release.yml on Mergifyio/mergify-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mergify_cli-2026.6.16.1-py3-none-macosx_11_0_arm64.whl -
Subject digest:
d39b4ec51a620414008cc2226d82da66d15d47616ffd3b051b28ddcae8c7da80 - Sigstore transparency entry: 1838735249
- Sigstore integration time:
-
Permalink:
Mergifyio/mergify-cli@9e9cae560dad681e8f498f149587b25e07948d1e -
Branch / Tag:
refs/tags/2026.6.16.1 - Owner: https://github.com/Mergifyio
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9e9cae560dad681e8f498f149587b25e07948d1e -
Trigger Event:
release
-
Statement type:
File details
Details for the file mergify_cli-2026.6.16.1-py3-none-macosx_10_12_x86_64.whl.
File metadata
- Download URL: mergify_cli-2026.6.16.1-py3-none-macosx_10_12_x86_64.whl
- Upload date:
- Size: 5.0 MB
- Tags: Python 3, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
324960f6145b0f80fc6f3e71e74d08c1aa6a0442e0e9ac1ae3fda0af61eac69c
|
|
| MD5 |
bd9f07f1acebee21776f6cff36ce4404
|
|
| BLAKE2b-256 |
95026d0335f532f5785e47cf2586de08632a92ccd1eeea3fc3762353d21f99a1
|
Provenance
The following attestation bundles were made for mergify_cli-2026.6.16.1-py3-none-macosx_10_12_x86_64.whl:
Publisher:
release.yml on Mergifyio/mergify-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mergify_cli-2026.6.16.1-py3-none-macosx_10_12_x86_64.whl -
Subject digest:
324960f6145b0f80fc6f3e71e74d08c1aa6a0442e0e9ac1ae3fda0af61eac69c - Sigstore transparency entry: 1838734822
- Sigstore integration time:
-
Permalink:
Mergifyio/mergify-cli@9e9cae560dad681e8f498f149587b25e07948d1e -
Branch / Tag:
refs/tags/2026.6.16.1 - Owner: https://github.com/Mergifyio
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9e9cae560dad681e8f498f149587b25e07948d1e -
Trigger Event:
release
-
Statement type:
