Setup

See the CLI installation guide for full instructions.

Quick install:

uv tool install mergify-cli

Mergify ships skills that teach AI coding agents how to work with Stacks, so they run mergify stack push instead of git push, amend commits instead of creating fixups, and follow stack conventions automatically.

Claude Code:

/plugin marketplace add Mergifyio/mergify-cli
/plugin install mergify-stack@mergify
/reload-plugins

Or run /plugin on its own and use the Marketplaces tab to add Mergifyio/mergify-cli, then pick mergify-stack from Discover.

Any agent supporting skills.sh (Cursor, Cline, and others):

npx skills add Mergifyio/mergify-cli

Stacks needs access to create PRs. Set the GITHUB_TOKEN environment variable, or install the GitHub CLI and run gh auth login.

Enable “Automatically delete head branches” in your GitHub repository settings (Settings > General > Pull Requests). When a stacked PR merges, this cleans up its remote branch automatically so the next PR in the chain can rebase onto main cleanly.

Run the setup command in your Git repository:

mergify stack setup

This installs:

• A commit-msg Git hook that automatically generates a Change-Id for every new commit. The Change-Id is how Stacks tracks the relationship between your local commits and their GitHub pull requests.

• A pre-push hook that warns you if you accidentally use git push instead of mergify stack push.

Create a test commit to confirm the hook is active:

echo "test" >> test.txt
git add test.txt
git commit -m "test: verify stack setup"

Check the commit message:

git log -1

You should see a Change-Id trailer at the bottom of the message:

test: verify stack setup

Change-Id: Ia1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2

Clean up the test commit if you don’t need it:

git reset HEAD~1

These optional Git config settings let you customize Stacks behavior:

Example:

git config mergify-cli.stack-create-as-draft true

Head to Creating Stacks to push your first stack.