mergify-cli
Mergify CLI is a tool that automates the creation and management of stacked pull requests on GitHub and handles CI results upload
Decision gist · record as of 2026-08-14
Yes, if you use Mergify and need CLI access to stacked PRs, merge queues, or CI Insights from your terminal or CI pipelines. The zero-dependency binary design and automatic GitHub authentication make it low-friction to deploy. The active maintenance (release 2 days old), permissive Apache-2.0 license, and stable exit codes for scripting make it reliable for production use. No known vulnerabilities.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >= 3.10.
- The CLI is a compiled binary that reuses your existing GitHub (`gh`) authentication; without a valid token or `gh` login, API commands will fail.
- Medium install friction due to platform-specific wheel distributions (macOS x86_64/arm64, Linux aarch64/x86_64, Windows).
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), which allows commercial and private use with minimal restrictions—suitable for both individual developers and organizations.
last release 2026-08-12 (2 days) · last repo commit 2026-08-13 · 29 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 397,169 downloads/mo, #6,964 on PyPI
Alternatives
Verify before relying
# Install via pip or download binary
pip install mergify-cli
# Authenticate using existing gh login
mergify stack push
mergify queue status --json- Whether the PyPI wheel is the recommended installation method or if Homebrew/install script is preferred for end users.
- Performance characteristics and typical latency for merge queue and stack operations at scale.
- Compatibility with GitHub Enterprise or other GitHub-compatible platforms beyond github.com.
What it is and what it does
Mergify CLI is a self-contained binary tool that brings Mergify's pull request and merge queue features to your terminal and CI pipelines. It lets you create and manage stacked pull requests (one PR per commit, kept in sync), inspect and control the merge queue, upload JUnit test results to CI Insights, schedule merge freezes, and validate your Mergify configuration—all without installing additional runtime dependencies.
The tool is built for both developer laptops and CI runners. It picks up your GitHub authentication automatically from your existing `gh` login, supports structured JSON output for scripting, logs to stderr to keep stdout pipeable, and provides stable exit codes for runbooks. It runs on Linux, macOS (both x86_64 and aarch64), and Windows.
Use it for
- Create and maintain stacked pull requests from local commits, keeping them automatically rebased and in sync with the trunk.
- Check merge queue status and manage queue entries from CI pipelines or developer scripts.
- Upload JUnit test results and CI metadata to Mergify's CI Insights for test health tracking and flaky-test quarantine.
- Schedule merge freezes for release windows or maintenance periods without manual intervention.
- Validate your .mergify.yml configuration file against the schema before merging changes to your repository.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use Mergify and need CLI access to stacked PRs, merge queues, or CI Insights from your terminal or CI pipelines.
The zero-dependency binary design and automatic GitHub authentication make it low-friction to deploy. The active maintenance (release 2 days old), permissive Apache-2.0 license, and stable exit codes for scripting make it reliable for production use. No known vulnerabilities.
Install
mergify-cli on PyPI
Before you install
Medium install friction due to platform-specific wheel distributions (macOS x86_64/arm64, Linux aarch64/x86_64, Windows). The package is actively maintained with a release 2 days old and no runtime dependencies, making it straightforward to deploy once downloaded.
Requires Python >= 3.10. The CLI is a compiled binary that reuses your existing GitHub (`gh`) authentication; without a valid token or `gh` login, API commands will fail.
License in practice
Licensed under Apache-2.0 (permissive), which allows commercial and private use with minimal restrictions—suitable for both individual developers and organizations.
Quickstart
# Install via pip or download binary
pip install mergify-cli
# Authenticate using existing gh login
mergify stack push
mergify queue status --jsonVerify before relying
- Whether the PyPI wheel is the recommended installation method or if Homebrew/install script is preferred for end users.
- Performance characteristics and typical latency for merge queue and stack operations at scale.
- Compatibility with GitHub Enterprise or other GitHub-compatible platforms beyond github.com.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 2 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 397,169 / month, #6,964 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: RustTopic :: Software Development :: Version Control :: Git |
Evidence: mergify_cli-2026.8.11.1-py3-none-macosx_10_12_x86_64.whl; mergify_cli-2026.8.11.1-py3-none-macosx_11_0_arm64.whl; mergify_cli-2026.8.11.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; mergify_cli-2026.8.11.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; mergify_cli-2026.8.11.1-py3-none-win_amd64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “stacked pull requests cli”
- mergify-cliMergify CLI is a command-line tool for managing stacked pull…
- ghstackghstack submits stacks of local Git commits to GitHub as separate…
- codeflashCodeflash is a CLI tool that uses LLMs to automatically generate,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Git packages
A Poetry plugin that automatically derives and injects version numbers from version control tags into your project during builds, using Dunamai to support multiple VCS systems.
Install it if you use Poetry 1.2.0+ and want to eliminate manual version management in your build workflow.
Automatically determines your Python package's version from Git or Mercurial tags and writes it to your build system, with customizable version formatting and optional runtime file generation.
Converts written-out number words (like "twenty one") into numeric digits (21), supporting positive integers and decimals up to 999,999,999,999.
No—install only if you have a legacy codebase already using it.
Lefthook is a Git hooks manager that installs and runs custom commands automatically before or after Git operations, supporting parallel execution across Node.js, Ruby, and other project types.
Provides HTTP NTLM authentication for the requests library, enabling clients to authenticate against NTLM-protected servers and proxies.
Adds NTLM authentication support to the requests library, enabling HTTP requests to servers and proxies that require NTLM challenge-response authentication.
However, the 443-day gap since last release and aging maintenance status mean you should verify compatibility with your current dependency versions and be prepared to…
See also ghstack · pytest-mergify · click-completion · metagit-cli · kimi-cli · boost-skill-cli · snowflake-cli · mycli · pairmux · huggingface-hub