Metadata-Version: 2.4
Name: mergify_cli
Version: 2026.5.5.1
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Typing :: Typed
Requires-Dist: httpx==0.28.1
Requires-Dist: jsonschema==4.26.0
Requires-Dist: rich==15.0.0
Requires-Dist: aiofiles==25.1.0
Requires-Dist: click==8.3.3
Requires-Dist: opentelemetry-exporter-otlp-proto-http==1.41.1
Requires-Dist: opentelemetry-sdk==1.41.1
Requires-Dist: tenacity==9.1.4
Requires-Dist: pyyaml==6.0.3
Requires-Dist: pydantic==2.13.3
Requires-Dist: questionary>=2.0.0
Requires-Dist: tzlocal==5.3.1
License-File: LICENSE
Summary: Mergify CLI is a tool that automates the creation and management of stacked pull requests on GitHub and handles CI results upload
Keywords: git,github,pull-request,stacked-pr,ci,merge
Author-email: Mergify Team <hello@mergify.com>
License-Expression: Apache-2.0
Requires-Python: >=3.13
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Changelog, https://github.com/Mergifyio/mergify-cli/releases
Project-URL: Documentation, https://docs.mergify.com
Project-URL: Homepage, https://mergify.com
Project-URL: Issues, https://github.com/Mergifyio/mergify-cli/issues
Project-URL: Repository, https://github.com/Mergifyio/mergify-cli

# Mergify CLI

Command-line tool for [Mergify](https://mergify.com): stacked pull requests,
CI insights, merge queue, scheduled freezes, and configuration management.

## Installation

```shell
uv tool install mergify-cli
# or
pipx install mergify-cli
```

Run `mergify --help` to list commands and `mergify <command> --help` for
details. See the [CLI docs](https://docs.mergify.com/cli/) for authentication
and global options (`--token`, `--repository`, `--api-url`).

## Commands

- **`mergify stack`** — Create and manage stacked pull requests.
  [Docs](https://docs.mergify.com/stacks/)
- **`mergify ci`** — Upload JUnit results, evaluate quarantine, detect git
  refs and CI scopes.
  [Docs](https://docs.mergify.com/ci-insights/)
- **`mergify queue`** — Monitor and manage the Mergify merge queue.
  [Docs](https://docs.mergify.com/merge-queue/)
- **`mergify freeze`** — Create and manage scheduled merge freezes.
  [Docs](https://docs.mergify.com/merge-protections/freeze/)
- **`mergify config`** — Validate and simulate Mergify configuration.
  [Docs](https://docs.mergify.com/configuration/file-format/#validating-with-the-cli)

## AI Agent Skills

Mergify CLI provides AI skills for managing stacked PRs and Git workflows,
compatible with [Claude Code](https://docs.anthropic.com/en/docs/claude-code),
[Cursor](https://cursor.sh), and [many other AI agents](https://skills.sh).

Install via npx (all agents):

```shell
npx skills add Mergifyio/mergify-cli
```

Install as a Claude Code plugin:

```shell
/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](LICENSE).

