Repository files navigation

GitHub Copilot is an AI pair programmertool that helps you write code faster and smarter. Copilot for Xcode is an Xcode extension that provides inline coding suggestions as you type and a chat assistant to answer your coding questions.

GitHub Copilot Chat provides suggestions to your specific coding tasks via chat.

GitHub Copilot Agent Mode provides AI-powered assistance that can understand and modify your codebase directly. With Agent Mode, you can:

• Get intelligent code edits applied directly to your files
• Run terminal commands and view their output without leaving the interface
• Search through your codebase to find relevant files and code snippets
• Create new files and directories as needed for your project
• Get assistance with enhanced context awareness across multiple files and folders
• Run Model Context Protocol (MCP) tools you configured to extend the capabilities

Agent Mode integrates with Xcode's environment, creating a seamless development experience where Copilot can help implement features, fix bugs, and refactor code with comprehensive understanding of your project.

You can receive auto-complete type suggestions from GitHub Copilot either by starting to write the code you want to use, or by writing a natural language comment describing what you want the code to do.

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

1. Install viaHomebrew:

   brew install --cask github-copilot-for-xcode

   Or download thedmg fromthe latest release.DragGitHub Copilot for Xcode into theApplications folder:

   

   Updates can be downloaded and installed by the app.

2. Open theGitHub Copilot for Xcode application (from theApplications folder). Accept the security warning.

   

3. A background item will be added to enable the GitHub Copilot for Xcode extension app to connect to the host app. This permission is usually automatically added when first launching the app.

   

4. Three permissions are required for GitHub Copilot for Xcode to function properly:Background,Accessibility, andXcode Source Editor Extension. For more details on why these permissions are required seeTROUBLESHOOTING.md.

   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 theGitHub Copilot for Xcode application settings to open theSystem Preferences to theExtensions panel. SelectXcode Source Editorand enableGitHub Copilot:

   

5. After granting the extension permission, open Xcode. Verify that theGithub Copilot menu is available and enabled under the XcodeEditormenu.
   

   

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

6. 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.

   

7. To install updates, clickCheck for Updates from the menu item or in thesettings application.

   After installing a new version, Xcode must be restarted to use the newversion correctly.

   New versions can also be installed fromdmg files downloaded from thereleases page. When installing a new version viadmg, the application mustbe run manually the first time to accept the downloaded from the internetwarning.

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

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

Open Copilot Chat in GitHub Copilot.

• Open via the Xcode menuXcode -> Editor -> GitHub Copilot -> Open Chat.

• Open via GitHub Copilot app menuOpen Chat.

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.