|
| 1 | +# Troubleshooting for Copilot for Xcode |
| 2 | + |
| 3 | +If you are having trouble with Copilot for Xcode follow these steps to resolve |
| 4 | +common issues: |
| 5 | + |
| 6 | +1. Check for updates and restart Xcode. Ensure that Copilot for Xcode has the |
| 7 | + [latest release](https://github.com/github/CopilotForXcode/releases/latest) |
| 8 | + by click `Check for Updates` in the settings or under the status menu. After |
| 9 | + updating, restart Xcode. |
| 10 | + |
| 11 | +2. Ensure that the Copilot for Xcode extension is enabled. Open Xcode and go to |
| 12 | + the top menu bar and open the `Editor` menu. If there is no `GitHub Copilot` |
| 13 | + menu is under `Editor` then [extension permission](#extension-permission) |
| 14 | + needs to be enabled. If the `GitHub Copilot` menu is shown but grayed out, |
| 15 | + then Xcode needs to be restarted to enable the extension. |
| 16 | + |
| 17 | +3. Need more help? If these steps don't resolve the issue, please [open an |
| 18 | + issue](https://github.com/github/CopilotForXcode/issues/new/choose). |
| 19 | + |
| 20 | +## Extension Permission |
| 21 | + |
| 22 | +GitHub Copilot for Xcode is an Xcode Source Editor extension and requires the |
| 23 | +extension to be enabled. In the Copilot for Xcode settings, clicking `Extension |
| 24 | +Permission` will open the System Settings to the Extensions page where `GitHub |
| 25 | +Copilot` can be enabled under `Xcode Source Editor`. |
| 26 | + |
| 27 | +Or you can navigate to the permission manually depending on your OS version: |
| 28 | + |
| 29 | +| macOS | Location | |
| 30 | +| :--- | :--- | |
| 31 | +| 15 | System Settings > General > Login Items > Extensions > Xcode Source Editor | |
| 32 | +| 13 & 14 | System Settings > Privacy & Security > Extensions > Xcode Source Editor | |
| 33 | +| 12 | System Preferences > Extensions | |
| 34 | + |
| 35 | +## Accessibility Permission |
| 36 | + |
| 37 | +GitHub Copilot for Xcode requires accessibility permission to receive |
| 38 | +information from the active Xcode editor. |
| 39 | + |
| 40 | +Enable in System Settings under `Privacy & Security` > `Accessibility` > |
| 41 | +`GitHub Copilot for Xcode Extension` and turn on the toggle. |
0 commit comments