xcdiff is an extensible tool that finds differences between your .xcodeproj project files. It can be thought of as git diff for your .xcodeproj files, can be used directly from the command line as well as a library supporting your own set of tools.

How to use xcdiff

Running the command xcdiff in your project directory will search for two .xcodeproj files in this directory and use all of xcdiff's comparators on the projects (e.g. targets, sources and headers).

You can also specify two particular projects for xcdiff to compare.

xcdiff -p1 OriginalProject.xcodeproj -p2 GeneratedProject.xcodeproj

Here is an example output:


To see a detailed report of differences you can specify the --verbose (-v) option.

xcdiff -p1 OriginalProject.xcodeproj -p2 GeneratedProject.xcodeproj -v



We would like to thank the authors and contributors of the following projects:

Code of Conduct

This project has adopted a [Code of Conduct][1].
If you have any concerns about the Code, or behavior which you have experienced
in the project, please contact us at [email protected].

Security Vulnerability Reporting

If you believe you have identified a security vulnerability in this project,
please send email to the project team at [email protected], detailing
the suspected issue and any methods you've found to reproduce it.

Please do NOT open an issue in the GitHub repository, as we'd prefer to keep
vulnerability reports private until we've had an opportunity to review and
address them.