AgentSwift

AgentSwift 다운로드
바이너리가 작동하려면 아래에 나열된 종속성(Dependencies)을 반드시 설치해야 합니다. 설정 명령은 아래를 참조하세요.

종속성 (Dependencies):

• Xcode
• Xcode command line tools
• xcodebuildmcp
• openspec

Apple 플랫폼 개발을 위해 자율적인 AI 코딩 에이전트 (AI coding agent)를 실행하는 네이티브 macOS 앱입니다. 만들고 싶은 내용을 설명하면, AgentSwift는 Claude를 사용하여 사용자가 Xcode를 직접 만지지 않고도 프로젝트를 탐색하고, 변경 사항을 구현하며, 빌드, 실행 및 검증을 수행합니다.

기능

AgentSwift는 다단계 에이전트 워크플로 (agentic workflow)를 구동합니다:

1. 탐색 (Discover) — Claude가 Xcode 프로젝트 구조와 스킴 (schemes)을 조사합니다.
2. 구현 (Implement) — 요청에 맞게 소스 파일을 수정합니다.
3. 빌드 (Build) — xcodebuildmcp를 실행하여 컴파일합니다.
4. 실행 / 검증 (Launch / Validate) — 시뮬레이터 또는 macOS에서 앱을 부팅하고, UI 자동화 (UI automation)를 실행하여 동작을 확인합니다.
5. 아카이브 (Archive) — 작업을 완료로 표시합니다.

요구 사항

• macOS 26.1+
• Xcode
• Node.js / npm
• Anthropic API 키

종속성 (Dependencies)

에이전트를 실행하기 전에 다음 두 가지 CLI를 설치하세요:

xcodebuildmcp

Xcode 프로젝트에 대한 빌드, 실행 및 UI 자동화 기능을 제공합니다.

npm install -g xcodebuildmcp

openspec

에이전트 세션 전반에 걸쳐 구현 사양 (implementation specs)을 추적합니다.

npm install -g @fission-ai/openspec

설정 (Setup)

1. Xcode에서 앱을 빌드하고 실행합니다.
2. Settings를 열고 Anthropic API 키를 입력합니다.
3. Project Folder (Xcode 프로젝트의 루트)를 선택합니다.
4. 선택 사항으로 드롭다운에서 iOS Simulator를 선택합니다.
5. 만들고 싶은 내용을 입력하고 Cmd+Return을 누릅니다.

첫 실행 시 에이전트는 프로젝트의 스킴 (scheme)과 시뮬레이터 타겟 (simulator target)을 탐색합니다. 이후 실행 시에는 탐색을 건너뛰고 바로 구현 단계로 넘어갑니다.

모델 (Models)

모델	사용 시점
Claude Opus 4.7	복잡한 작업, 대규모 코드베이스
Claude Sonnet 4.6	빠른 반복, 가벼운 작업

주요 동작 (Key behaviors)

• 메시지 큐잉 (Message queuing) — 에이전트가 실행 중인 동안 새로운 메시지를 보내면, 가장 최근의 메시지가 이전 메시지를 대체합니다.
• 빌드 캐싱 (Build caching) — 첫 번째 빌드 이후 스킴 (scheme), 프로젝트 경로 (project path), 시뮬레이터 ID (simulator ID)가 추출되어 자동으로 재사용됩니다.
• 오류 에스컬레이션 (Error escalation) — 에이전트는 실패 시 한 번의 수정을 시도하며, 무한 루프에 빠지는 대신 사용자에게 오류를 전달합니다.

아키텍처 (Architecture)

AgentSwiftApp.swift    — 앱 진입점 (app entry point)
ContentView.swift      — UI, 뷰 모델 (view models), 에이전트 루프 (agentic loop)
AnthropicService.swift — Anthropic API 클라이언트 (streaming SSE)
...

외부 Swift 의존성 없음 — 순수 SwiftUI + Foundation 기반입니다.