# Install mergiraf with Homebrew, apk, MacPorts, Nix, pacman, zypper, scoop, winget

Syntax-aware git merge driver. Version 0.18.0 via Homebrew; verified 2026-07-14. Also installable with nix: nix profile install nixpkgs#mergiraf.

## Install

```sh
sudo av install brew:mergiraf
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mergiraf
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install mergiraf
```

  Evidence: MacPorts ports tree: devel/mergiraf/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add mergiraf
```

  Evidence: Alpine Linux edge package indexes: mergiraf from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#mergiraf
```

  Evidence: nixpkgs package indexes: pkgs/by-name/me/mergiraf/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S mergiraf
```

  Evidence: Arch Linux sync databases: mergiraf from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install mergiraf
```

  Evidence: openSUSE Tumbleweed package metadata: mergiraf from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/mergiraf
```

  Evidence: Scoop official bucket manifest trees: bucket/mergiraf.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id Mergiraf.Mergiraf -e
```

  Evidence: Windows Package Manager source index: Mergiraf.Mergiraf from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:mergiraf
- **Package manager:** Homebrew
- **Version:** 0.18.0
- **Source summary:** Syntax-aware git merge driver
- **Homepage:** <https://mergiraf.org>
- **Last updated:** 2026-07-14T18:47:06Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- mergiraf (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.18.0
## Project history and usage

Mergiraf is a syntax-aware merge driver for Git created by Antonin Delpeuch after exploring the limitations of line-based merge conflict resolution and earlier structured-merge prototypes. The project positions itself as a practical merge driver for daily version-control workflows: Git still performs ordinary line-based merges where they succeed, while Mergiraf uses syntax trees and language-specific knowledge when a line-based conflict can be resolved structurally.

### Project history

The tool integrates through Git's custom merge-driver mechanism and can also be run after a conflict with `mergiraf solve`. Its documentation emphasizes conservative behavior: unresolved or suspicious cases keep conflict markers, while automatically solved cases can be reviewed with `mergiraf review` and reported with `mergiraf report`. It also supports Jujutsu workflows through `jj resolve --tool mergiraf`.

### How it is used

Mergiraf's ecosystem role is adjacent to tools like Difftastic: it applies tree awareness to version-control conflicts rather than only to human-readable diffs. Its supported-language list spans common programming languages such as C/C++, Go, Java, JavaScript, Python, Rust, TypeScript, and structured formats such as JSON, TOML, YAML, XML, `go.mod`, and requirements files. Package managers distribute it as a developer-tool CLI that teams can opt into globally or per repository through Git attributes.

### Sources

- <https://antonin.delpeuch.eu/posts/mergiraf-a-syntax-aware-merge-driver-for-git/>
- <https://formulae.brew.sh/formula/mergiraf>
- <https://mergiraf.org/>
- <https://mergiraf.org/installation.html>
- <https://mergiraf.org/languages.html>
- <https://mergiraf.org/usage.html>


## Security Notes

No matching local secret-handling manifest was found for mergiraf. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/git/config
## Other Package-Manager Records

- Nix - mergiraf: normalized package name match | nixpkgs package indexes: pkgs/by-name/me/mergiraf/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - mergiraf - 0.17.0-r0: normalized package name match | Alpine Linux edge package indexes: mergiraf from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | syntax-aware git merge driver for a growing collection of programming languages and file formats | https://mergiraf.org/
- apk - mergiraf-doc - 0.17.0-r0: normalized package name match | Alpine Linux edge package indexes: mergiraf-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | syntax-aware git merge driver for a growing collection of programming languages and file formats (documentation) | https://mergiraf.org/
- pacman - mergiraf - 0.18.0-1: normalized package name match | Arch Linux sync databases: mergiraf from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A syntax-aware git merge driver for a growing collection of programming languages and file formats | https://mergiraf.org/
- zypper - mergiraf - 0.18.0-1.2: normalized package name match | openSUSE Tumbleweed package metadata: mergiraf from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | A syntax-aware git merge driver | https://mergiraf.org/
- MacPorts - mergiraf: normalized package name match | MacPorts ports tree: devel/mergiraf/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/mergiraf: normalized package name match | Scoop official bucket manifest trees: bucket/mergiraf.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - Mergiraf.Mergiraf: normalized package name match | Windows Package Manager source index: Mergiraf.Mergiraf from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/mergiraf.yml](https://github.com/mxcl/pkgdb/blob/main/combined/mergiraf.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
