# intitni/copilotforxcode architecture

> Architecture diagram of the GitHub repository intitni/copilotforxcode, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/intitni/copilotforxcode
- Repository: https://github.com/intitni/copilotforxcode

## Overview

Copilot for Xcode is a macOS Xcode source-editor extension with a background service for AI code suggestions, chat, and prompt-driven code modification. The main workflow begins with an Xcode command or editor change; the service reads editor/workspace context, dispatches to a configured provider, then presents suggestions or chat/modification results in Xcode-facing UI. The README also documents custom commands and GitHub Copilot, Codeium, and other LLM support. Several feature modules are unsampled, so their internal links are omitted or marked unverified.

Main entry points: [`Core/Sources/Service/RealtimeSuggestionController.swift`](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/Service/RealtimeSuggestionController.swift) (Realtime suggestions), [`Core/Sources/ChatService/ChatService.swift`](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/ChatService/ChatService.swift) (Chat service), [`Core/Sources/Service/Service.swift`](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/Service/Service.swift) (Background service), [`Tool/Sources/SuggestionProvider`](https://github.com/intitni/copilotforxcode/tree/main/Tool/Sources/SuggestionProvider) (Suggestion providers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Xcode integration"]
  node_xcode["Xcode editor<br/>[SourceEditor.swift]"]
  node_extension["Editor commands"]
  node_bridge["Extension XPC"]
end

subgraph group_runtime["Service runtime"]
  node_service["Background service<br/>[Service.swift]"]
  node_inspector["Xcode inspector"]
  node_workspace["Workspace context<br/>[Workspace.swift]"]
end

subgraph group_ai["AI features"]
  node_realtime["Realtime suggestions"]
  node_suggestion["Suggestion providers"]
  node_chat["Chat service<br/>[ChatService.swift]"]
  node_context["Chat context"]
  node_plugins["Chat plugins"]
  node_llm["LLM services"]
  node_promptcode["Prompt to code"]
  node_commands["Custom commands"]
end

subgraph group_ui["User interface"]
  node_gui["GUI controller"]
  node_widgets["Suggestion widgets"]
  node_chatview["Chat tab UI"]
end

subgraph group_settings["Providers and settings"]
  node_copilot["GitHub Copilot"]
  node_codeium["Codeium"]
  node_preferences[("Preferences<br/>[UserDefaults.swift]")]
end

node_developer(("Xcode user"))
node_llmprovider(("Configured LLM"))

node_developer -->|"runs commands"| node_extension
node_extension -.->|"sends requests"| node_bridge
node_bridge -->|"dispatches XPC"| node_service
node_service -->|"starts"| node_realtime
node_realtime -->|"observes editor"| node_inspector
node_realtime -->|"updates context"| node_workspace
node_realtime -.->|"requests completion"| node_suggestion
node_suggestion -.->|"dispatches provider"| node_copilot
node_suggestion -.->|"dispatches provider"| node_codeium
node_copilot -.->|"requests suggestions"| node_llmprovider
node_codeium -.->|"requests suggestions"| node_llmprovider
node_service -->|"starts"| node_gui
node_gui -->|"controls panels"| node_widgets
node_gui -->|"builds chat tabs"| node_chatview
node_developer -->|"uses chat"| node_chat
node_chat -.->|"collects context"| node_context
node_chat -->|"dispatches functions"| node_plugins
node_chat -.->|"requests completion"| node_llm
node_llm -.->|"sends prompts"| node_llmprovider
node_developer -->|"requests modification"| node_promptcode
node_promptcode -.->|"requests code"| node_llm
node_developer -->|"configures commands"| node_commands
node_commands -.->|"extends chat"| node_chat
node_preferences -.->|"configures feature"| node_realtime
node_xcode -.->|"exposes editor state"| node_inspector

click node_xcode "https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/XcodeInspector/SourceEditor.swift"
click node_extension "https://github.com/intitni/copilotforxcode/tree/main/EditorExtension"
click node_bridge "https://github.com/intitni/copilotforxcode/blob/main/ExtensionService/XPCController.swift"
click node_service "https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/Service/Service.swift"
click node_inspector "https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/XcodeInspector/XcodeInspector.swift"
click node_workspace "https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/Workspace/Workspace.swift"
click node_realtime "https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/Service/RealtimeSuggestionController.swift"
click node_suggestion "https://github.com/intitni/copilotforxcode/tree/main/Tool/Sources/SuggestionProvider"
click node_copilot "https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/GitHubCopilotService/Services/GitHubCopilotSuggestionService.swift"
click node_codeium "https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/CodeiumService/Services/CodeiumSuggestionService.swift"
click node_chat "https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/ChatService/ChatService.swift"
click node_context "https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/ChatService/AllContextCollector.swift"
click node_plugins "https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/ChatService/ChatPluginController.swift"
click node_llm "https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/OpenAIService/ChatGPTService.swift"
click node_promptcode "https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/PromptToCodeService/PromptToCodeServiceType.swift"
click node_commands "https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/HostApp/CustomCommandSettings/CustomCommand.swift"
click node_gui "https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/Service/GUI/GraphicalUserInterfaceController.swift"
click node_widgets "https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/SuggestionWidget/WidgetWindowsController.swift"
click node_chatview "https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/ChatGPTChatTab/ChatGPTChatTab.swift"
click node_preferences "https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/Preferences/UserDefaults.swift"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_xcode,node_extension,node_bridge,node_developer toneBlue
class node_service,node_inspector,node_workspace toneAmber
class node_realtime,node_suggestion,node_chat,node_context,node_plugins,node_llm,node_promptcode,node_commands toneMint
class node_gui,node_widgets,node_chatview toneRose
class node_copilot,node_codeium,node_preferences,node_llmprovider toneIndigo
```

## Components

### Xcode integration

- [Xcode editor](https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/XcodeInspector/SourceEditor.swift): `Tool/Sources/XcodeInspector/SourceEditor.swift`
- [Editor commands](https://github.com/intitni/copilotforxcode/tree/main/EditorExtension): `EditorExtension`
- [Extension XPC](https://github.com/intitni/copilotforxcode/blob/main/ExtensionService/XPCController.swift): `ExtensionService/XPCController.swift`

### Service runtime

- [Background service](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/Service/Service.swift): `Core/Sources/Service/Service.swift`
- [Xcode inspector](https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/XcodeInspector/XcodeInspector.swift): `Tool/Sources/XcodeInspector/XcodeInspector.swift`
- [Workspace context](https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/Workspace/Workspace.swift): `Tool/Sources/Workspace/Workspace.swift`

### AI features

- [Realtime suggestions](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/Service/RealtimeSuggestionController.swift): `Core/Sources/Service/RealtimeSuggestionController.swift`
- [Suggestion providers](https://github.com/intitni/copilotforxcode/tree/main/Tool/Sources/SuggestionProvider): `Tool/Sources/SuggestionProvider`
- [Chat service](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/ChatService/ChatService.swift): `Core/Sources/ChatService/ChatService.swift`
- [Chat context](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/ChatService/AllContextCollector.swift): `Core/Sources/ChatService/AllContextCollector.swift`
- [Chat plugins](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/ChatService/ChatPluginController.swift): `Core/Sources/ChatService/ChatPluginController.swift`
- [LLM services](https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/OpenAIService/ChatGPTService.swift): `Tool/Sources/OpenAIService/ChatGPTService.swift`
- [Prompt to code](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/PromptToCodeService/PromptToCodeServiceType.swift): `Core/Sources/PromptToCodeService/PromptToCodeServiceType.swift`
- [Custom commands](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/HostApp/CustomCommandSettings/CustomCommand.swift): `Core/Sources/HostApp/CustomCommandSettings/CustomCommand.swift`

### User interface

- [GUI controller](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/Service/GUI/GraphicalUserInterfaceController.swift): `Core/Sources/Service/GUI/GraphicalUserInterfaceController.swift`
- [Suggestion widgets](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/SuggestionWidget/WidgetWindowsController.swift): `Core/Sources/SuggestionWidget/WidgetWindowsController.swift`
- [Chat tab UI](https://github.com/intitni/copilotforxcode/blob/main/Core/Sources/ChatGPTChatTab/ChatGPTChatTab.swift): `Core/Sources/ChatGPTChatTab/ChatGPTChatTab.swift`

### Providers and settings

- [GitHub Copilot](https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/GitHubCopilotService/Services/GitHubCopilotSuggestionService.swift): `Tool/Sources/GitHubCopilotService/Services/GitHubCopilotSuggestionService.swift`
- [Codeium](https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/CodeiumService/Services/CodeiumSuggestionService.swift): `Tool/Sources/CodeiumService/Services/CodeiumSuggestionService.swift`
- [Preferences](https://github.com/intitni/copilotforxcode/blob/main/Tool/Sources/Preferences/UserDefaults.swift): `Tool/Sources/Preferences/UserDefaults.swift`

### Other components

- **Xcode user**
- **Configured LLM**

## Connections

- Xcode user → Editor commands: runs commands (evidence: `README.md`)
- Editor commands → Extension XPC: sends requests
- Extension XPC → Background service: dispatches XPC
- Background service → Realtime suggestions: starts (evidence: `Core/Sources/Service/Service.swift`)
- Realtime suggestions → Xcode inspector: observes editor (evidence: `Core/Sources/Service/RealtimeSuggestionController.swift`)
- Realtime suggestions → Workspace context: updates context (evidence: `Core/Sources/Service/RealtimeSuggestionController.swift`)
- Realtime suggestions → Suggestion providers: requests completion
- Suggestion providers → GitHub Copilot: dispatches provider
- Suggestion providers → Codeium: dispatches provider
- GitHub Copilot → Configured LLM: requests suggestions
- Codeium → Configured LLM: requests suggestions
- Background service → GUI controller: starts (evidence: `Core/Sources/Service/Service.swift`)
- GUI controller → Suggestion widgets: controls panels (evidence: `Core/Sources/Service/GUI/GraphicalUserInterfaceController.swift`)
- GUI controller → Chat tab UI: builds chat tabs (evidence: `Core/Sources/Service/GUI/GraphicalUserInterfaceController.swift`)
- Xcode user → Chat service: uses chat (evidence: `README.md`)
- Chat service → Chat context: collects context
- Chat service → Chat plugins: dispatches functions (evidence: `Core/Sources/ChatService/ChatPluginController.swift`)
- Chat service → LLM services: requests completion
- LLM services → Configured LLM: sends prompts
- Xcode user → Prompt to code: requests modification (evidence: `README.md`)
- Prompt to code → LLM services: requests code
- Xcode user → Custom commands: configures commands (evidence: `README.md`)
- Custom commands → Chat service: extends chat
- Preferences → Realtime suggestions: configures feature (evidence: `Core/Sources/Service/RealtimeSuggestionController.swift`)
- Xcode editor → Xcode inspector: exposes editor state (evidence: `Tool/Sources/XcodeInspector/XcodeInspector.swift`)
