How theblixguy/xcode-copilot-server works
xcode-copilot-server is a local API proxy that lets Xcode use GitHub Copilot through OpenAI-, Anthropic-, and OpenAI Responses-compatible provider modes. The principal flow is CLI startup and configuration, provider route registration, request/session preparation, Copilot streaming, and—where enabled—tool calls bridged back to Xcode. README-described OpenAI MCP access and launchd operation are included; their detailed runtime wiring is not fully excerpted, so uncertain links are omitted. The graph emphasizes documented and indexed relationships rather than inferring calls from naming.
Main entry points: claude/provider.ts Claude API · codex/provider.ts Codex API · startup.ts Server startup · openai/provider.ts OpenAI API
Components 29
Server entry
- CLI
proxy-server/src/index.ts - Server startup
proxy-server/src/startup.ts - App context
proxy-server/src/context.ts
API providers
- OpenAI API
proxy-server/src/providers/openai/provider.ts - Claude API
proxy-server/src/providers/claude/provider.ts - Codex API
proxy-server/src/providers/codex/provider.ts - Provider tool results
proxy-server/src/providers/claude/tool-results.ts - Codex tool results
proxy-server/src/providers/codex/tool-results.ts
Session and streaming
- Session configuration
proxy-server/src/providers/shared/session-config.ts - Prompt preparation
proxy-server/src/providers/shared/prompt-utils.ts - Conversation continuation
proxy-server/src/providers/shared/continuation.ts - Stream orchestration
proxy-server/src/providers/shared/streaming-orchestrator.ts - Conversation manager
proxy-server/src/conversation-manager.ts - Streaming core
proxy-server/src/providers/shared/streaming-core.ts - Claude streaming
proxy-server/src/providers/claude/streaming.ts - Codex streaming
proxy-server/src/providers/codex/streaming.ts
Tool bridge
- MCP bridge routes
proxy-server/src/tool-bridge/routes.ts - Bridge registration
proxy-server/src/tool-bridge/index.ts - Bridge state
proxy-server/src/tool-bridge/state.ts - Tool call router
proxy-server/src/tool-bridge/tool-router.ts
Configuration and operations
- Configuration
proxy-server/src/config.ts - CLI validation
proxy-server/src/cli-validators.ts - Settings patchers
proxy-server/src/settings-patcher/index.ts - Claude settings
proxy-server/src/settings-patcher/claude.ts - Codex settings
proxy-server/src/settings-patcher/codex.ts - Launchd agent
proxy-server/src/launchd/agent.ts
Other components
- Xcode
- Copilot SDK service
- Xcode MCP tools
Connections 40
- Xcode → OpenAI API: sends completions
- Xcode → Claude API: sends requests
- Xcode → Codex API: sends responses
- CLI → Server startup: starts server
proxy-server/src/index.ts - CLI → CLI validation: parses options
proxy-server/src/index.ts - Server startup → Configuration: loads config
proxy-server/src/startup.ts - Server startup → App context: builds context
proxy-server/src/startup.ts - Server startup → Settings patchers: patches settings
proxy-server/src/startup.ts - Server startup → Launchd agent: registers agent
proxy-server/src/startup.ts - OpenAI API → Session configuration: configures session
proxy-server/src/providers/openai/provider.ts - Claude API → Session configuration: configures session
proxy-server/src/providers/claude/provider.ts - Codex API → Session configuration: configures session
proxy-server/src/providers/codex/provider.ts - Claude API → Prompt preparation: filters prompt
proxy-server/src/providers/claude/provider.ts - Codex API → Prompt preparation: filters prompt
proxy-server/src/providers/codex/provider.ts - Claude API → Conversation continuation: handles continuation
proxy-server/src/providers/claude/provider.ts - Codex API → Conversation continuation: handles continuation
proxy-server/src/providers/codex/provider.ts - Claude API → Conversation manager: selects conversation
proxy-server/src/providers/claude/provider.ts - Codex API → Conversation manager: selects conversation
proxy-server/src/providers/codex/provider.ts - Claude API → Bridge registration: resolves bridge
proxy-server/src/providers/claude/provider.ts - Codex API → Bridge registration: resolves bridge
proxy-server/src/providers/codex/provider.ts - Claude API → Stream orchestration: orchestrates stream
proxy-server/src/providers/claude/provider.ts - Codex API → Stream orchestration: orchestrates stream
proxy-server/src/providers/codex/provider.ts - Stream orchestration → Conversation manager: updates conversation
proxy-server/src/providers/shared/streaming-orchestrator.ts - Claude API → Claude streaming: handles stream
proxy-server/src/providers/claude/provider.ts - Codex API → Codex streaming: handles stream
proxy-server/src/providers/codex/provider.ts - Claude streaming → Streaming core: uses stream core
proxy-server/src/providers/claude/streaming.ts - Codex streaming → Streaming core: uses stream core
proxy-server/src/providers/codex/streaming.ts - OpenAI API → Copilot SDK service: serves Copilot
- Claude API → Copilot SDK service: serves Copilot
- Codex API → Copilot SDK service: serves Copilot
- Bridge registration → MCP bridge routes: registers routes
proxy-server/src/tool-bridge/index.ts - MCP bridge routes → Tool call router: registers tool request
proxy-server/src/tool-bridge/routes.ts - Conversation manager → Bridge state: creates state
proxy-server/src/conversation-manager.ts - Bridge state → Tool call router: owns router
proxy-server/src/tool-bridge/state.ts - Claude API → Provider tool results: resolves results
proxy-server/src/providers/claude/provider.ts - Codex API → Codex tool results: resolves results
proxy-server/src/providers/codex/provider.ts - Settings patchers → Claude settings: delegates patching
proxy-server/src/settings-patcher/index.ts - Settings patchers → Codex settings: delegates patching
proxy-server/src/settings-patcher/index.ts - Codex settings → Launchd agent: sets launchctl vars
proxy-server/src/settings-patcher/codex.ts - OpenAI API → Xcode MCP tools: accesses Xcode tools