/CopilotForXcode

Xcode extension for GitHub Copilot

Primary LanguageSwiftMIT LicenseMIT

GitHub Copilot for Xcode

Demo of GitHub Copilot for Xcode

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

Beta Preview Policy

Use of the GitHub Copilot Xcode Extension is subject to GitHub'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.

Requirements

Getting Started

  1. Download the dmg from the latest release. Updates can be downloaded and installed by the app.

  2. Open the dmg and drag the GitHub Copilot for Xcode.app into the Applications folder.

    Screenshot of opened dmg

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

    Screenshot of downloaded from the internet warning

  4. A background item will be added to enable Copilot to start when Xcode is opened.

    Screenshot of background item

  5. Two permissions are required: Accessibility and Xcode Source Editor Extension. For more on why these permissions are required see TROUBLESHOOTING.md.

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

    Screenshot of accessibility permission request

    The Xcode Source Editor Extension permission needs to be enabled manually. Click Extension Permission from the Copilot for Xcode settings to open the System Preferences to the Extensions panel. Select Xcode Source Editor and enable GitHub Copilot:

    Screenshot of extension permission

  6. After granting the extension permission, please restart Xcode to ensure the Github Copilot menu is available and not disabled under the Xcode Editor menu.

    Screenshot of Xcode Editor GitHub Copilot menu item

    Keyboard shortcuts can be set for all menu items in the Key Bindings section of Xcode preferences.

  7. To sign into GitHub Copilot, click the Sign 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.

    Screenshot of sign-in popup

  8. To install updates, click Check 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 from dmg files downloaded from the releases page. When installing a new version via dmg, the application must be run manually the first time to accept the downloaded from the internet warning.

  9. To avoid confusion, we recommend disabling Predictive code completion under Xcode > Preferences > Text Editing > Editing.

  10. Press tab to accept the first line of a suggestion, hold option to view the full suggestion, and press option + tab to accept the full suggestion.

    Screenshot of welcome screen

License

This project is licensed under the terms of the MIT open source license. Please refer to LICENSE.txt for the full terms.

Privacy

We follow responsible practices in accordance with our Privacy Statement.

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

Support

We’d love to get your help in making GitHub Copilot better! If you have feedback or encounter any problems, please reach out on our Feedback forum.

Acknowledgements

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 in Credits.rtf.