Files

T

cx-git-agent c118996746 feat: CxIDE v1 — native macOS SwiftUI IDE with agentic AI assistant

- SwiftUI macOS app with C++17 code analysis engine (ObjC++ bridge)
- Agentic AI loop: LLM plans → tool calls → execution → feedback loop
- 15 agent tools: file ops, terminal, git, xcode build, code intel
- 7 persistent terminal tools with background session management
- Chat sidebar with agent step rendering and auto-apply
- NVIDIA NIM API integration (Llama 3.3 70B default)
- OpenAI tool_calls format with prompt-based fallback
- Code editor with syntax highlighting and multi-tab support
- File tree, console view, terminal view
- Git integration and workspace management

2026-04-21 16:05:52 -05:00

6.3 KiB

Raw Blame History

CxIDE — Architecture

Overview

CxIDE is a native macOS SwiftUI code editor with an embedded C++ static analysis engine and an in-process MCP (Model Context Protocol) agent providing 56 AI-assisted coding tools.

┌──────────────────────────────────────────────────────────────┐
│                    SwiftIDEApp.swift                          │
│                    (@main entry point)                        │
└──────────────────────┬───────────────────────────────────────┘
                       │
              ┌────────▼────────┐
              │ IDEContainerView │
              │  (root layout)   │
              └───┬──────────┬──┘
                  │          │
     ┌────────────▼──┐   ┌──▼───────────────┐
     │  Activity Bar  │   │   VSplitView      │
     │  + Sidebar     │   │  ┌─────────────┐  │
     │                │   │  │ CodeEditor   │  │
     │  • Explorer    │   │  │ + Minimap    │  │
     │  • Search      │   │  ├─────────────┤  │
     │  • Snippets    │   │  │ ConsoleView  │  │
     │  • Debug       │   │  │ (5 panels)   │  │
     │  • Agent       │   │  └─────────────┘  │
     │  • Settings    │   └───────────────────┘
     └───────────────┘

Layers

Presentation (Views/)

File	Purpose
`IDEContainerView.swift`	Root layout: toolbar, activity bar, sidebar, editor, console, status bar
`CodeEditorView.swift`	Syntax-highlighted text editor with line numbers and breakpoints
`ConsoleView.swift`	Bottom panel: Console, Problems, Output, Debug, Agent chat
`AgentSidebarView.swift`	Agent sidebar: status, quick actions, tool browser

State (ViewModels/)

File	Purpose
`EditorViewModel.swift`	Central app state: tabs, content, console, diagnostics, agent integration

Domain (Models/)

File	Purpose
`Models.swift`	Diagnostic, ConsoleEntry, ActivityPanel, BottomPanel, AgentMessage, AgentStatus, AgentToolInfo
`CodeEngine.swift` (Models/)	CodeEngine protocol, FileItem

Services (Services/)

File	Purpose
`AgentService.swift`	Agent orchestration: wraps MCPServer, routes messages, manages tool calls

C++ Engine (Core/)

File	Purpose
`CodeEngine.hpp`	C++ header: EngineConfig, Token, SymbolInfo, AnalysisReport
`CodeEngine.cpp`	Swift tokenizer, symbol extraction, complexity metrics, issue detection
`SwiftEngineWrapper.h`	Objective-C interface (40+ methods)
`SwiftEngineWrapper.mm`	ObjC++ bridge implementation
`CodeEngine.swift`	CppEngineController (Swift facade), SwiftRuntimeEngine

MCP Agent (Agent/)

File	Purpose
`MCPServer.swift`	MCP 2025-03-26 server: JSON-RPC 2.0, tool/resource/prompt registration
`MCPTypes.swift`	Protocol types: JsonRpcRequest, MCPToolDefinition, AnyCodable
`AgentConfig.swift`	Configuration: paths, exclusions, profiles, security
`AgentMemory.swift`	Session memory: file accesses, decisions, tasks, symbols

Agent Tools (Agent/Tools/)

Module	Tools	Description
`FileOpsTools.swift`	10	read, write, patch, search, list, tree, info, delete, move, find
`CodeIntelTools.swift`	10	complete, explain, review, refactor, fix, document, test, security, symbols, diff_explain
`GitTools.swift`	8	status, diff, log, commit, branch, blame, stash, show
`ProjectTools.swift`	5	detect, run, deps, config, create
`TerminalTools.swift`	2	exec, env
`XcodeTools.swift`	10	build, test, analyze, schemes, devices, swift_check, clean, archive, provisioning, swift_format
`DiagnosticsTools.swift`	5	workspace, lint, todo, duplicates, complexity
`AutoPilotTools.swift`	6	plan, execute, memory, context, diff, status

Engine Layer (Root)

File	Purpose
`SwiftIDEApp.swift`	@main entry, WindowGroup, keyboard shortcuts
`EngineFactory.swift`	Factory: SwiftCodeEngine (macOS) vs SandboxedSwiftEngine
`SwiftCodeEngine.swift`	Full Swift execution via `/usr/bin/swift` Process
`SandboxedSwiftEngine.swift`	Safe line-by-line Swift interpreter

Data Flow

User Input
    │
    ▼
EditorViewModel          ◄── Commands, keyboard shortcuts
    │
    ├──► SwiftCodeEngine  ── Run code via Process ──► Console output
    │
    ├──► CppEngineController ── C++ analysis ──► Diagnostics
    │         │
    │         └──► SwiftEngineWrapper (ObjC++) ──► CodeEngine (C++)
    │
    └──► AgentService ── JSON-RPC ──► MCPServer
              │
              └──► 56 Tools (file ops, git, code intel, Xcode, etc.)

Agent Integration (In-Process)

The MCP agent runs in-process — no HTTP server needed:

// AgentService.swift
let server = MCPServer(config: agentConfig)
FileOpsTools.register(on: server, config: agentConfig, memory: memory)
// ... 7 more tool modules

// Tool call: build JSON-RPC request, call directly
let response = server.handleJsonRpc(requestData)

Message routing:

User types in Agent panel or triggers command
AgentService.sendMessage() detects intent via keyword matching
Routes to appropriate tool call (e.g., "list files" → file_list)
Tool result displayed as AgentMessage in the chat panel

Sandbox mode: When enabled, only read-only tools are permitted (30 of 56).

Security

Path traversal protection in AgentConfig (resolvePath())
Dangerous command blocking in terminal tools
API key redaction in logs
Sandbox mode restricts to read-only operations
pre-commit hook scans for hardcoded secrets

6.3 KiB Raw Blame History