Install the App

1. Install the App

   You can install it manually, by downloading the Copilot for Xcode.app from the latest release.

   Or, you can install it via Homebrew:

   brew install --cask copilot-for-xcode

   Optionally, move the app to the /Applications folder.

   Open the app, the app will create a launch agent to setup a background running Service that does the real job.

   Note

   If you don’t install the app into the /Applications folder, you need to manually click the Setup Launch Agent button in the app to install the launch agent. The launch agent will be installed in ~/Library/LaunchAgents/com.intii.CopilotForXcode.CommunicationBridge.plist in this case.

2. Enable the Extension

   Enable the extension in System Settings.app.

   • macOS 15

     From the Apple menu located in the top-left corner of your screen click System Settings. Navigate to General then Login Items & Extensions. Click Xcode Source Editor and tick Copilot for Xcode.

   • macOS 14

     From the Apple menu located in the top-left corner of your screen click System Settings. Navigate to Privacy & Security then toward the bottom click Extensions. Click Xcode Source Editor and tick Copilot.

   • Older Versions

     If you are using macOS Monterey, enter the Extensions menu in System Preferences.app with its dedicated icon.

   Can’t find the extension?

   If you don’t see the Copilot extension in the list, please try:

   1. Open Copilot for Xcode once.
   2. Close Xcode.
   3. Move Xcode outside of Applications folder and move it back.

3. Granting Permissions to the App

   The first time the app is open and command run, the extension will ask for the necessary permissions.

   Alternatively, you may manually grant the required permissions by navigating to the Privacy & Security tab in the System Settings.app.

   • To grant permissions for the Accessibility API, click Accessibility, and drag CopilotForXcodeExtensionService.app to the list. You can locate the extension app by clicking Reveal Extension App in Finder in the host app.
   

   If you encounter an alert requesting permission that you have previously granted, please remove the permission from the list and add it again to re-grant the necessary permissions.