App FAQ
Q: Is the pre-compiled version identical to the open source version?
A: No. You can see it as a fork of the open source version.
Q: Do I have to keep the app running?
A: You don’t have to keep the host app running. The service app will launch whenever Xcode launches or a command is called. If the service app crashes, you can run a command to restart it.
Q: The extension doesn’t show up in the Editor
menu.
A: Please make sure the extension is enabled in the System Settings app.
macOS 15: Please make sure Copilot for Xcode
is turned on in System Settings.app > General > Login Items & Extensions > Xcode Source Editor
.
macOS 14: Please make sure Copilot
is turned on in System Settings.app > Privacy & Security > Extensions > Xcode Source Editor Extension
.
If you can’t find this settings page, please try
- Renaming Xcode.app to something else and rename it back.
- Moving Xcode.app out of the Applications folder and move it back.
Q: The extension says it can’t connect to the extension service or the extension service version loading never ends.
A: Please try the following solutions one by one.
-
Make sure the app is in the Applications folder. If multiple versions of the extension exist on your machine, it’s also possible that Xcode is using the older version of the extension.
-
Using the setup launch agent button to set up the launch agent and restart the app.
-
Check if the toggle in System Settings > General > Login Items > Allow in the Background > Copilot for Xcode is off. Turn it on if it is.
-
Reinstall the launch agent with the following step:
- Delete Copilot for Xcode.app, make sure it’s also not in the trash bin.
- Restart Mac, so that it will clean the list up.
- Install the app again in the Applications folder.
-
If the button in the app doesn’t work, please try setting it up manually:
-
Create
com.intii.CopilotForXcode.CommunicationBridge.plist
and put it inside~/Library/LaunchAgents
.This is an example of the .plist file. Please note that the application path may need to be adjusted based on your installation location.
-
After creating the file, run these from the terminal:
-
Q: The extension complains that it has no access to the Accessibility API
A: Please check if the Accessibility API permission is set up correctly.
Q: I quit the service app accidentally, how do I restart it?
A: Every time you run a command, open Xcode, open Copilot for Xcode.app, the service app will be launched.
Q: How do I remove commands from the KeyBinding settings page if they are no longer available?
A: The key binding configuration is stored at ~/Library/Developer/Xcode/UserData/KeyBindings
. You can open the configuration file in any text editor and remove any item whose CommandID
contains com.intii.CopilotForXcode.EditorExtension
.
Q: The widget says it can’t run a command.
A: Some commands require to click on the Xcode menu bar > Editor > Copilot > Command. The app uses the Accessibility API to perform the click. However, in this case, the app may fail to find the menu item.
Please ensure that you have enabled the Source Editor Extension in the System Settings app to avoid this issue.
Q: The Copilot menu grays out after updating Copilot for Xcode. Or the keybindings stop working.
A: If it only happens after updating Copilot for Xcode, It’s an expected behavior, please restart Xcode to to let it reload the extension to finish the update. If it happens in other cases, please open an issue to let me know.
Q: The app loses track of Xcode.
A: Please re-activate the observations from the menu app. If it happens all the time, consider turning “Re-activate Xcode Inspector when Accessibility API malfunctioning detected” on in the advanced settings.
Q: Keybindings are not working.
A: If the keybindings you set in Xcode are not working, it may be an Xcode bug. You can try setting up a keybinding from the System Settings.app > Keyboard > Keyboard Shortcuts > App Shortcuts.
For example, type Editor->Copilot->Accept Suggestion
in the menu title field to set up a keybinding for the accept suggestion command.
Q: The app seems to make typing in Xcode slower.
A: Please try export the spin log from Activity.app and submit an issue with the log attached.
Suggestion
Q: I turned on real-time suggestions, but nothing happened
A: Try typing something in the editor and wait for a little while, if you see an animation from the real-time suggestion indicator or the floating widget, that means the real-time suggestion is correctly triggered.
Q: The editor jumps when I accept a suggestion
A: It happens when the “Copilot” menu grays out or you have enabled “Always accept suggestion with Accessibility API” in the advanced tab.
For the first case, please restart Xcode.
Q: I clicked the accept button but nothing happened. (or using keybindings, tab)
A: If the accept button/keybinding/tab doesn’t work, it’s very likely the Copilot menu in Xcode - Menu Bar - Editor is greyed out. It’s an Xcode bug that usually happens right after you update the extension. It can only be cured by restarting Xcode. So please remember to restart Xcode after updating the extension.
Another possible cause is you have multiple versions of Copilot for Xcode.app on your Mac, and Xcode is confused by them.
You can also give the toggle “Trigger command with Accessibility API” in the advanced settings. Please open an issue if this toggle fixes the problem.
Q: I can’t accept suggestions with tab
A: Please
- check that the toggle is on.
- Restart macOS. (It can be a macOS bug)
Q: I can’t get suggestions at all
A: If you can’t get suggestions for files located in the Downloads or the Desktop folder that requires specific permission, please go to System Settings.app > Privacy & Security > Files and Folders to make sure the permission to CopilotForXcodeExtensionService are on.
If this is not the case, and you do see the circular widget animating as you type, please check the other sections about the suggestion services for details.
Chat
Q: I have subscribed to ChatGPT Plus but..
A: The ChatGPT Plus and the ChatGPT API key are different products using different billing systems, and ChatGPT Plus is only available at chat.openai.com.
Please get an API key from https://platform.openai.com/account/api-keys and blame OpenAI for the mess. You may have to enter some billing details before the API key works, you can find more details from openai.com.
Q: When I tried to use gpt-4 models, I got the message “The model: gpt-4-xx does not exist”.
A: To access GPT-4 models, please check the link from OpenAI for details.
Q: I ask the bot what model it’s using, but the answer is incorrect
A: The bot doesn’t know what model it’s using, but I will try to reply to you as if it knows.
You can get the correct answer from ChatGPT because they have added this information to the system prompt for you. But every token is money, we didn’t include this in the system prompt.
Q: The model is responding with weird content that is not readable.
A: Please make sure the temperature of the chat feature and the chat tab is lower than 1. A higher temperature will make the bot too creative and generate weird response that human can’t read.
Plus License
Q: How to deactivate the license key?
A: If you have the key activated in Copilot for Xcode, you can click “Deactivate” in the Plus tab to deactivate.
If you have just got a new Mac but forgot to deactivate it before selling it, you can still deactivate it following this instruction
If the app can’t find your activation after an update, it may be that the key is missing for some unknown reason. Please follow the same instructions to deactivate it.
If you can’t access the order details on Lemon Squeezy, you can contact me to deactivate it for you.
Others
Q: Will it work in future Xcode updates?
A: I don’t know. This extension uses many tricks to do its job, and these tricks can break in the future.
Q: How to delete this app?
A: Quit Xcode. Move Copilot for Xcode.app to the trash bin. Delete ~/Library/Application Support/com.intii.copilotforxcode
.