Copilot for Xcode is an Xcode Source Editor Extension that provides Github Copilot and ChatGPT support for Xcode. It uses the LSP provided through Copilot.vim to generate suggestions and displays them as comments or in a separate window.

Thanks to LSP-copilot for showing the way to interact with Copilot. And thanks to LanguageClient for the Language Server Protocol support in Swift.

• Prerequisites
• Permissions Required
• Installation and Setup
  • Install
  • Enable the Extension
  • Sign In GitHub Copilot
  • Setting Up OpenAI API Key
  • Granting Permissions to the App
  • Managing CopilotForXcodeExtensionService.app
• Update
• Commands
• Key Bindings
• Prevent Suggestions Being Committed
• Limitations
• License

For frequently asked questions, check FAQ.

For development instruction, check Development.md.

• Public network connection.

For suggestion features:

• Node installed to run the Copilot LSP.
• Active GitHub Copilot subscription.

For chat and prompt to code features:

• Valid OpenAI API key.

• Folder Access
• Accessibility API

If you are concerned about key logging and cannot trust the binary, we recommend examining the code and building it yourself. To address any concerns, you can specifically search for CGEvent.tapCreate, AXObserver, AX___ within the code.

You can install it via Homebrew:

brew install --cask copilot-for-xcode

Or install it manually, by downloading the Copilot for Xcode.app from the latest release, and extract it to the Applications folder.

Then set it up with the following steps:

1. Open the app, the app will create a launch agent to setup a background running Service that does the real job.
2. Optionally setup the path to Node. The default value is just node, Copilot for Xcode.app will try to find the Node from the PATH available in a login shell. If your Node is installed somewhere else, you can run which node from terminal to get the path.

Enable the extension in System Settings.app.

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.

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

1. In the host app, click GitHub Copilot to enter the GitHub Copilot account settings.
2. Click "Sign In", and you will be directed to a verification website provided by GitHub, and a user code will be pasted into your clipboard.
3. After signing in, go back to the app and click "Confirm Sign-in" to finish.

1. In the host app, click OpenAI to enter the OpenAI account settings.
2. Enter your api key to the text field.

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.

This app runs whenever you open Copilot for Xcode.app or Xcode.app. You can quit it with its menu bar item that looks like a steering wheel.

You can also set it to quit automatically when the above 2 apps are closed.

If the app was installed via Homebrew, you can update it by running:

brew upgrade --cask copilot-for-xcode

Alternatively, You can use the in-app updater or download the latest version manually from the latest release.

If you are upgrading from a version lower than 0.7.0, please run Copilot for Xcode.app at least once to let it set up the new launch agent for you and re-grant the permissions according to the new rules.

If you find that some of the features are no longer working, please first try regranting permissions to the app.

• Get Suggestions: Get suggestions for the editing file at the current cursor position.
• Next Suggestion: If there is more than one suggestion, switch to the next one.
• Previous Suggestion: If there is more than one suggestion, switch to the previous one.
• Accept Suggestion: Add the suggestion to the code.
• Reject Suggestion: Remove the suggestion comments.
• Toggle Real-time Suggestions: When turn on, Copilot will auto-insert suggestion comments to your code while editing.
• Real-time Suggestions: Call only by Copilot for Xcode. When suggestions are successfully fetched, Copilot for Xcode will run this command to present the suggestions.
• Prefetch Suggestions: Call only by Copilot for Xcode. In the background, Copilot for Xcode will occasionally run this command to prefetch real-time suggestions.

About real-time suggestions

Whenever you stop typing for a few milliseconds, the app will automatically fetch suggestions for you, you can cancel this by clicking the mouse, or pressing Escape or the arrow keys.

• Chat with Selection: Open a chat window, if there is a selection, the selected code will be added to the prompt.
• Explain Selection: Open a chat window and explain the selected code.

Chat commands are not available in comment mode.

The chat panel supports chat plugins that may not require an OpenAI API key. For example, if you need to use the /run plugin, you just type

/run echo hello

If you need to end a plugin, you can just type

/exit

• Prompt to Code: Open a prompt to code window, where you can use natural language to write or edit selected code.

Prompt to code commands are not available in comment mode.

It looks like there is no way to add default key bindings to commands, but you can set them up in Xcode settings > Key Bindings. You can filter the list by typing copilot in the search bar.

A recommended setup that should cause no conflict is

Essentially using ⌥⇧ as the "access" key combination for all bindings.

Another convenient method to access commands is by using the ⇧⌘/ shortcut to search for a command in the menu bar.

Since the suggestions are presented as comments, they are in your code. If you are not careful enough, they can be committed to your git repo. To avoid that, I would recommend adding a pre-commit git hook to prevent this from happening.

#!/bin/sh

# Check if the commit message contains the string
if git diff --cached --diff-filter=ACMR | grep -q "/*========== Copilot Suggestion"; then
  echo "Error: Commit contains Copilot suggestions generated by Copilot for Xcode."
  exit 1
fi

• The first run of the extension will be slow. Be patient.
• The extension uses some dirty tricks to get the file and project/workspace paths. It may fail, it may be incorrect, especially when you have multiple Xcode windows running, and maybe even worse when they are in different displays. I am not sure about that though.
• The suggestions are presented as C-style comments in comment mode, they may break your code if you are editing a JSON file or something.

MIT.