XcodePaI(/ɛksˈkoʊd pæl/) is an AI pair programmer tool that enchance your Xcode AI function which helps you write code faster and smarter. XcodePaI is an Xcode extension that provides local proxy to enchange Xcode 26 coding assistant and inline coding suggestions as you type.
XcodePaI provide local proxy server for Xcode to regconize as local model provider. Multiple model provider with OpenAI API format could be proxy to Xcode coding assistant.
XcodePaI enhance Xcode coding assistant with 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
- 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 coding assistant's environment, creating a seamless development experience where assistant can help implement features, fix bugs, and refactor code with comprehensive understanding of your project inside Xcode.
You can receive auto-complete type suggestions from any available model provider 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.
OpenAI format v1/completions
and v1/chat/completions
endpionts with partial supported model could be use as your code suggestion/completion provider.
- macOS 15+
- Xcode 16+
-
download the
zip
from the latest release. Unzip zip file, dragXcodePaI.app
into theApplications
folder. -
Open the
XcodePaI
application (from theApplications
folder). Accept the security warning. -
Open
XcodePaI
Settings -> Provider to add Model Provider.XcodePaI accept model provider such as Ollama/Alibaba Cloud/OpenRouter and other provider support OpenAI
v1
endpoint format. -
Open model provider detail to sync models from service
-
[Opiontal] Open
XcodePaI
Settings -> MCP to add MCP service -
[Opiontal] Create custom model config
Open Intelligent in Xcode configuration window.
- Open via the Xcode menu
Xcode -> Settings -> Intelligent
.
- Add XcodePaI as Local Model Provider
- Check XcodePaI local model provider info
- Create new chat via Xcode Code Assistant sidebar, and choose XcodePaI as the model provider.
- Via statusbar button menu, the model used in code assistant chat window could be change
Two permissions are required for XcodePaI to function code completions properly: Accessibility
, and Xcode Source Editor Extension
. For more details on why these permissions are required see TROUBLESHOOTING.md.
-
The
Accessibility
permission can be requested via XcodePaI Settings -> Completions -> Accesibility Permission:Via Grant Permission button, XcodePaI will open permission request window for Accessibility permission.
The Accessibility permission could be granted in the System Preferences:
-
The
Xcode Source Editor Extension
permission needs to be enabled manually. ClickExtension Permission
from theXcodePaI
application completions settings to open the System Preferences to theExtensions
panel. SelectXcode Source Editor
and enableXcodePaI
: -
After granting the extension permission, open Xcode. Verify that the
XcodePaI
menu is available and enabled under the XcodeEditor
menu.Keyboard shortcuts can be set for all menu items in the
Key Bindings
section of Xcode preferences. -
To enable
Xcode Source Editor Extension
, clickSync Text Settings
in the menu.
Please grant any access permission for XcodePaI and XcodePaI Xcode Extension.
-
To avoid confusion, we recommend disabling
Predictive code completion
underXcode
>Preferences
>Text Editing
>Editing
. -
Press
tab
to accept the first line of a suggestion, holdoption
to view the full suggestion, and pressoption
+tab
to accept the full suggestion.Press
tab
to accept the first line of a suggestion, holdoption
to view the full suggestion, and pressoption
+tab
to accept the full suggestion.
This project is licensed under the terms of the MIT open source license. Please refer to LICENSE.txt for the full terms.
Thank you to @intitni and @Github for creating the code completions method for Xcode that this project is based on.
Attributions can be found under About when running the app or in Credits.rtf.