Mergify — Claude Code plugin: what it does, how to install
Operates Mergify merge queues, manages stacked pull requests, and validates configuration files directly from Claude Code.
/plugin install mergify@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-community
/plugin install mergify@claude-community
/plugin marketplace add anthropics/claude-plugins-officialWhat mergify does
This plugin links Claude Code with the mergify command-line binary. The assistant can split local commit series into individual pull requests using mergify stack push and sync stacked branches against trunk.
The integration inspects merge queue status, triggers test reporting pipelines, and verifies .mergify.yml files against the schema. Authentication relies on mergify auth login or a defined MERGIFY_TOKEN variable.
Stack commands talk directly to GitHub endpoints. Missing GitHub credentials will cause stack synchronization to fail, even with a valid Mergify session.
What it helps with
- turn local commits into stacked pull requests
- inspect repository merge queue progress
- validate
.mergify.ymlfiles against the schema - submit JUnit test reports from CI environments
Example prompts for the agent
- Check the repository merge queue state using
mergify queue status - Push local commits as a pull request stack with
mergify stack push - Validate our
.mergify.ymlconfiguration file
How to install mergify
Plugin marketplace
/plugin install mergify@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-community/plugin install mergify@claude-community/plugin marketplace add anthropics/claude-plugins-officialStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about mergify
How to install Mergify in Claude Code?
First register the marketplace by running /plugin marketplace add anthropics/claude-plugins-official. Then install the package with /plugin install mergify@claude-plugins-official.
What does the Mergify plugin do?
It enables Claude Code to run Mergify CLI commands to monitor merge queues, manage stacked branches, and inspect configuration.
What credentials does the CLI require?
Mergify API commands use credentials from mergify auth login or MERGIFY_TOKEN. Stack management operations require a GitHub credential from gh or GITHUB_TOKEN.
