---
id: mergify-cli
version: "2026.8.11.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

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

License: permissive · Maintenance: active · Downloads: 397.2K/mo

## 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 above — verify before relying.

Mergify CLI is a command-line tool for managing stacked pull requests, merge queues, CI test results, and scheduled freezes on GitHub, distributed as a self-contained binary with no runtime dependencies.

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

pip install mergify-cli
uv add mergify-cli
poetry add mergify-cli

## Installing mergify-cli

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.

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 --json

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.

Verify 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_current
- Install friction: medium
- Maintenance: active
- Downloads: 397.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

stacked pull requests cli, github merge queue management, ci test results upload, git workflow automation, mergify command line tool, git-workflow, ci-cd, github-automation

[View on SkillFed](https://skillfed.io/packages/mergify-cli) · [View on PyPI](https://pypi.org/project/mergify-cli/)