xcutility

0.2.0

Star
A tool to find and delete files that are missing from Xcode projects
swift objective-c ios macos xcode tvos
jeffctown/xcutility

What's New

0.2.0

2019-03-24T14:37:45Z

Breaking

  • Renamed the tool xcutility
  • Renamed commands

xcutility

Swift Version GitHub release GitHub license

Build Statuscodecov.io

xcutility is a tool to find and delete unused files from Xcode projects.

It recursively searches through a path to find all of the path's Xcode projects and files, and will tell you which files are not referenced or built in any of your Xcode projects.

Installation

Using a pre-built package:

You can install xcutility by downloading xcutility.pkg from the latest GitHub release and running it.

Compiling from source:

You can also build from source by cloning this project and running make install (Xcode 10.2 or later).

Quick Start

  • Find Swift files not referenced in any Xcode projects: xcutility norefs --extensions .swift

  • Find Objective C files not referenced in any Xcode projects: xcutility norefs --extensions .m,.h

  • Find Swift & Objective C files not referenced in any Xcode projects: xcutility norefs --extensions .m,.h,.swift

  • Find Swift files not compiled in any Xcode projects: xcutility unbuilt --extensions .swift

  • Find Objective C files not compiled in any Xcode projects: xcutility unbuilt --extensions .m

  • Find Swift & Objective C files not compiled in any Xcode projects: xcutility unbuilt --extensions .m,.swift

Usage

Help

$ xcutility help
Available commands:

   all       Find files that are not built or referenced in any Xcode projects
   help      Display general or command-specific help
   norefs    Find files that are not referenced in any Xcode projects
   unbuilt   Find files that are referenced in Xcode but not built in any build phases
   version   Display the current version of xcutility

Unreferenced Files

Find Files that are Unreferenced by any Xcode Projects in the Current Directory

xcutility norefs

Find Files that are Unreferenced by any Xcode Projects In a Specific Path

xcutility norefs --path ~/MySweetSweetApp/

Find Files With a Certain Extension that are Unreferenced by any Xcode Projects

xcutility norefs --extensions .swift

Find Only Files With Multiple Extensions that are Unreferenced by any Xcode Projects

xcutility norefs --extensions .swift,.h,.m

Find And Delete Files With Multiple Extensions that are Unreferenced by any Xcode Projects

xcutility norefs --extensions .swift,.h,.m --delete

Find Unreferenced Files Verbosely

xcutility norefs --verbose

Find Unreferenced Files Combined Usage

xcutility norefs --path ~/MySweetSweetApp/ --extension .swift,.h,.m --verbose --delete

Unbuilt Files

Find Files that are not built by any Xcode Project Build Phases in the Current Directory

xcutility unbuilt

Find Files that are not built by any Xcode Project Build Phases in a specific path

xcutility unbuilt --path ~/MySweetSweetApp/

Find Files With a Certain Extension that are not built by any Xcode Projects Build Phases

xcutility unbuilt --extensions .swift

Find Only Files With Multiple Extensions that are not built by any Xcode Projects Build Phases

xcutility unbuilt --extensions .swift,.h,.m

Find And Delete Files With Multiple Extensions that are not built by any Xcode Projects Build Phases

xcutility unbuilt --extensions .swift,.m --delete

Find Unbuilt Files Verbosely

xcutility unbuilt --verbose

Find Unbuilt Files Combined Usage

xcutility unbuilt --path ~/MySweetSweetApp/ --extension .swift,.m --verbose --delete

License

xcutility is released under the MIT license.

Description

  • Swift Tools 5.0.0
View More Packages from this Author

Dependencies

Last updated: Sat Sep 27 2025 18:48:34 GMT-0900 (Hawaii-Aleutian Daylight Time)