Repository files navigation

GitHub Copilot is an AI pair programmertool that helps you write code faster and smarter. Copilot for Xcode is an Xcodeextension that provides inline coding suggestions as you type.

Use of the GitHub Copilot Xcode Extension is subject toGitHub's Pre-Release Terms. We want to remind you that:

Beta Previews may not be supported or may change at any time. You may receive confidential information through those programs that must remain confidential while the program is private. We'd love your feedback to make our Beta Previews better.

• macOS 12+
• Xcode 8+
• A GitHub Copilot subscription. To learn more, visithttps://github.com/features/copilot.

1. Download thedmg fromthe latest release.Updates can be downloaded and installed by the app.

2. Open thedmg and drag theGitHub Copilot for Xcode.app into theApplications folder.

   

3. On the first opening the application it will warn that it was downloaded from the internet. ClickOpen to proceed.

   

4. A background item will be added for the application to be able to start itself when Xcode starts.

   

5. Two permissions are required:Accessibility andXcode Source Editor Extension.

   The first time the application is run theAccessibility permission should be requested:

   

   TheXcode Source Editor Extension permission needs to be enabled manually. ClickExtension Permission from theCopilot for Xcode settings to open theSystem Preferences to theExtensions panel. SelectXcode Source Editorand enableGitHub Copilot:

   

6. After granting the extension permission, please restart Xcode so theGithub Copilot menu is available under the XcodeEditor menu.
   

   

   Keyboard shortcuts can be set for all menu items in theKey Bindingssection of Xcode preferences.

7. To sign into GitHub Copilot, click theSign in button in the settings application. This will open a browser window and copy a code to the clipboard. Paste the code into the GitHub login page and authorize the application.

   

8. To install updates, clickCheck for Updates from the menu item or in the settings application. After installing a new version, Xcode must be restarted to use the new version correctly. New versions can also be installed fromdmg files downloaded from the releases page. When installing a new version viadmg, the application must be run manually the first time to accept the downloaded from the internet warning.

9. To avoid confusion, we recommend disablingPredictive code completion underXcode >Preferences >Text Editing >Editing.

10. Presstab to accept the first line of a suggestion, holdoption to viewthe full suggestion, and pressoption +tab to accept the full suggestion.

    

This project is licensed under the terms of the MIT open source license. Pleaserefer toLICENSE.txt for the full terms.

We follow responsible practices in accordance with ourPrivacy Statement.

To get the latest security fixes, please use the latest version of the GitHubCopilot for Xcode.

We’d love to get your help in making GitHub Copilot better! If you havefeedback or encounter any problems, please reach out on ourFeedbackforum.

Thank you to @intitni for creating the original project that this is based on.

Attributions can be found under About when running the app or inCredits.rtf.