Skip to content
Plugin for Xcode to quickly import your headers on the fly.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
Auto-Importer.xcodeproj changing project name to match plugin Oct 7, 2014
.travis.yml adding travis file Oct 22, 2015
LICENSE license added Oct 6, 2014

Auto Importer for Xcode

CI Status

Quickly import your headers on the fly without having to manually go to the top of your file and type the import statement.


  • Allows to import a class/protocol/category header by selecting some text matching its name.
  • Allows to import from a list of all classes/protocols/categories and headers in your project.


  • Xcode 6



  • Install Alcatraz and search for Auto-Importer


  • Clone and build the project, then restart Xcode.


  • ⌘ + ctrl + H after selecting some text (or you can have no selection at all)
  • If the selected text matches the name of a class/protocol or category method, it will import the header and you're done, otherwise it will show a list of filtered identifiers and headers...
  • start typing the keyword of your import
  • use ↑ or ↓ keys to navigate
  • press ↵ or double click to add an import

NOTE: on the list, classes are shown as [C], protocols as [P] and category methods as [ClassExtended()]


Run rm -r ~/Library/Application\ Support/Developer/Shared/Xcode/Plug-ins/AutoImporter.xcplugin/

Known Issues

  • If you get an error alert while typing the shortcut, it may be because of a bad bundle build, so delete ~/Library/Application Support/Alcatraz/Plug-ins/Auto-Importer, ~/Library/Application Support/Developer/Shared/Xcode/Plug-ins/Auto-Importer and ~/library/Developer/Xcode/DerivedData/* and reinstall from scratch.
  • When two workspaces (and thus two windows) are open, there is no distinction between workspaces and all identifiers are shown on the listing.
  • Avoid using 'InstallApplicationEventHandler' since it prevent other plugins to use it.



  • Read headers from frameworks.


Thanks to the Peckham project since I used some pieces from it.

About Citrusbyte


This software is lovingly maintained and funded by Citrusbyte. At Citrusbyte, we specialize in solving difficult computer science problems for startups and the enterprise.

At Citrusbyte we believe in and support open source software.

Citrusbyte and the Citrusbyte logo are trademarks or registered trademarks of Citrusbyte, LLC.

You can’t perform that action at this time.