스프쌤
AI 에이전트

BAMA, 화면 캡처에서 스위프트UI 빌드까지 맥 네이티브 앱을 복제하는 AI 에이전트 스킬

✍ 야금야금⏱ 19분 소요2026-10-23👁
← 목록으로 돌아가기

마음에 드는 맥 유틸리티 앱의 연간 구독료 결제 창 앞에서 망설였던 적이 있다면, 화면을 캡처하는 것만으로 내 기기 안에서 돌아가는 순수 네이티브 앱을 만들어내는 에이전트의 등장은 개발의 판도를 바꿉니다.

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: BAMA를 통한 macOS 네이티브 앱 자동화 리버스 엔지니어링 및 빌드 파이프라인

✦ KR 핵심 요약: BAMA는 기존 맥 애플리케이션의 인터페이스를 시각적으로 분석해 기획안과 사용자 스토리를 작성하고, Swift와 SwiftUI 및 SwiftData 코드로 직접 컴파일하는 오픈소스 에이전트 스킬입니다. 무거운 웹 래퍼를 배제하고 Xcode GUI 조작 없이 터미널 상에서 경량 로컬 네이티브 앱을 완성합니다.

🌐 Global Takeaway: BAMA (Build Any Mac App) is an open-source agent skill framework that reverse-engineers target macOS applications via visual screen captures into native Swift and SwiftUI apps. Operating entirely without the Xcode GUI, it systematically plans user stories, implements SwiftData persistence, and validates light and dark mode snapshots per commit.

아래 그림은 BAMA가 기존 맥 앱을 분석하고 네이티브 코드로 재구성하는 전체 파이프라인과 기존 개발 방식의 구조적 차이를 보여줍니다.

기존 웹 래퍼 방식 vs BAMA 네이티브 파이프라인
일렉트론 및 웹 래퍼
  • 웹 브라우저 엔진 번들링으로 메모리 과다 점유
  • macOS 고유 디자인 가이드라인 미준수
  • 클라우드 종속 저장소로 인한 프라이버시 위험
  • 시스템 단축키 및 메뉴 막대 제어 한계
VS
BAMA 네이티브 파이프라인
  • Swift 및 SwiftUI 기반의 경량 네이티브 바이너리
  • macOS 휴먼 인터페이스 가이드라인 자동 반영
  • SwiftData 기반의 100% 로컬 데이터베이스 격리
  • Xcode GUI 조작 없는 터미널 기반 자동 빌드
단순 웹뷰 복제와 달리 시스템 네이티브 API와 로컬 저장소를 직접 제어합니다.
BAMA의 3단계 네이티브 앱 재생성 워크플로우
1. 복제(Clone)앱 화면 연속 캡처 및 화면 인덱스 카탈로그 생성
→
2. 계획(Plan)화면을 검증 가능한 인수 기준과 사용자 스토리로 변환
→
3. 빌드(Build)라이트·다크 스냅샷 테스트 통과 후 스토리별 깃 커밋
클론부터 계획 수립 및 커밋 단위 빌드까지 이어지는 선형 파이프라인입니다.

💻 1. Xcode 없는 맥 앱 개발: BAMA의 등장 배경

데스크톱 운영체제 중에서도 macOS는 사용자 인터페이스와 시스템 통합에 대한 눈높이가 유난히 높은 생태계입니다. 섬세한 폰트 렌더링, 특유의 반투명 블러 효과, 시스템 메뉴 막대와의 자연스러운 결합, 그리고 즉각적인 키보드 단축키 반응성은 웹 기반 래퍼 기술이 흉내 내기 어려운 네이티브 앱만의 영역으로 남아 있었습니다. 그러나 이러한 완성도를 갖추려면 복잡한 Xcode 개발 환경을 다루고, 방대한 AppKit 및 SwiftUI API 문서를 숙지해야 하는 기술적 진입 장벽이 존재했습니다.

개발자 Dave Ebbelaar가 공개한 오픈소스 프로젝트 BAMA(Build Any Mac App)는 바로 이 지점에서 시작되었습니다. GitHub 공개 직후 빠르게 개발자들의 주목을 받으며 스타를 모은 BAMA는, 대규모 언어 모델(LLM)과 에이전트 워크플로우를 결합하여 사용자가 원하는 기존 맥 앱의 기능을 스크린샷 캡처만으로 재현하는 체계를 제시합니다. 사용자가 일일이 복잡한 프로그래밍 언어의 문법을 작성하지 않아도, 에이전트가 소프트웨어의 UI와 동작 원리를 역추적하여 순수 네이티브 코드로 변환해 냅니다.

이러한 전환은 일렉트론(Electron) 같은 크롬 임베디드 프레임워크에 지친 파워 유저들에게 중요한 대안으로 부상하고 있습니다. 단 하나의 작은 유틸리티를 실행하기 위해 수백 메가바이트의 메모리를 소모하고 배터리를 낭비하던 방식에서 벗어나, 시스템 자원을 최소한으로 점유하는 진짜 네이티브 바이너리를 에이전트가 직접 빌드해 Dock에 꽂아주는 환경이 열렸기 때문입니다.

1-1. 복잡한 IDE를 벗어난 헤드리스 빌드 패러다임

전통적인 애플 플랫폼 개발은 Xcode라는 거대한 통합 개발 환경(IDE)에 전적으로 의존해 왔습니다. 프로젝트 설정부터 인터페이스 빌더 조작, 코드 사이닝, 시뮬레이터 구동까지 모든 과정이 마우스 클릭 기반의 GUI에 묶여 있었기 때문에, CLI 환경에서 동작하는 자율 AI 에이전트가 개입하기에 기술적 제약이 컸습니다.

BAMA는 무거운 Xcode 인터페이스를 실행하지 않고도 순수 Swift Package 구조와 커맨드라인 빌드 도구를 활용하여 애플리케이션 라이프사이클을 통제합니다. 텍스트 프롬프트와 시각적 데이터만을 단서로 삼아 에이전트가 프로젝트 디렉터리를 조작하고, 백그라운드에서 컴파일러를 호출하여 바이너리를 생성함으로써 완전한 헤드리스(Headless) 개발 자동화를 달성합니다.


⚙️ 2. BAMA의 작동 원리와 3단계 에이전트 파이프라인

BAMA의 핵심 메커니즘은 '무작정 코드를 생성하는 방식'이 아니라, 소프트웨어 엔지니어링의 정석적인 설계 흐름을 에이전트의 단계별 스킬로 체계화했다는 데 있습니다. 사용자가 목표로 삼는 애플리케이션의 화면을 전달받았을 때, BAMA는 복제(Clone), 계획(Plan), 빌드(Build)로 이어지는 3단계 파이프라인을 엄격히 준수합니다.

BAMA 에이전트 시스템 아키텍처 계층
오케스트레이션 레이어/bama 라우터 및 상태 머신
에이전트 스킬 레이어app-brief, clone, research, user-stories
애플리케이션 템플릿Swift Package, SwiftData 모델, 스냅샷 스크립트
macOS 네이티브 코어SwiftUI, AppKit, 시스템 렌더링 엔진
최상단 라우터부터 최하단 macOS 시스템 프레임워크까지 연결되는 구조입니다.

첫 번째 복제(Clone) 단계에서는 컴퓨터 유즈(Computer Use) 기능이나 브라우저 자동화 도구를 활용해 대상 앱의 모든 화면과 모달, 설정 창을 스크린샷으로 캡처합니다. 에이전트는 이 이미지들을 단순 저장하는 것에 그치지 않고, 각 화면의 위계와 전환 관계를 파악하여 '스크린 인덱스(Screen Index)' 문서를 구축합니다. 소프트웨어의 전체 지도를 시각적으로 먼저 완성하는 과정입니다.

두 번째 계획(Plan) 단계에서는 스크린 인덱스를 기반으로 구체적인 요구사항 정의가 이루어집니다. 에이전트는 사용자 인터페이스 뒤편에 숨은 비즈니스 로직을 추론하여 마일스톤별 사용자 스토리(User Stories)를 작성합니다. 각 스토리에는 단순 설명이 아니라 통과 여부를 검증할 수 있는 명확한 인수 기준(Acceptance Criteria)이 코드 형태로 부여됩니다.

마지막 빌드(Build) 단계는 철저하게 마이크로 커밋 단위로 진행됩니다. 에이전트는 하나의 사용자 스토리를 구현할 때마다 컴파일을 수행하고, 라이트 모드와 다크 모드 각각에서 페이지 뷰를 렌더링한 스냅샷을 생성합니다. 정의된 테스트 스위트를 통과하고 UI 시각적 회귀가 발생하지 않았음이 확인되어야만 비로소 하나의 깃(Git) 커밋이 생성됩니다.

2-1. 컴퓨터 유즈 기반의 화면 캡처와 스크린 인덱싱

리버스 엔지니어링의 첫걸음은 UI 구성 요소를 빠짐없이 포착하는 일입니다. BAMA의 clone 스킬은 화면 제어 에이전트가 직접 앱 내비게이션을 순회하도록 지시합니다. 버튼 클릭, 드롭다운 메뉴 열림, 사이드바 토글 상태 등 다양한 인터랙션을 유도하며 픽셀 단위 캡처를 수집합니다.

수집된 이미지는 화면 고유의 메타데이터와 결합되어 구조화된 인덱스 파일로 변환됩니다. 이는 LLM이 코드를 작성할 때 시각적 문맥(Visual Context)을 온전히 유지하도록 만들어 주며, 개발자가 일일이 컴포넌트 규격을 설명하지 않아도 버튼의 여백, 폰트 굵기, 색상 테마가 원본과 유사하게 추출되는 밑바탕이 됩니다.


🧱 3. BAMA 핵심 스킬 세트와 아키텍처 구조

BAMA 프로젝트 내부를 살펴보면 .claude-plugin, skills/, specs/, scripts/ 등 표준화된 에이전트 스킬 규격을 따르고 있습니다. 복합적인 소프트웨어 개발 작업을 단일 프롬프트로 해결하려 하지 않고, 역할을 세밀하게 분할한 모듈형 스킬들이 유기적으로 결합하는 구조입니다.

스킬 명칭 소속 단계 핵심 역할 및 기능
bama Router 현재 작업 디렉터리 상태를 분석하여 다음에 실행할 최적의 스킬을 호출하는 라우터
app-brief Start 사용자 아이디어를 구조화된 단일 페이지 명세서(One-page Brief)로 정리
new-mac-app Start Swift Package, SwiftData 모델, 빌드 스크립트, 스냅샷 환경을 포함한 기본 골격 생성
research Plan 시장, 사용자, 기능 요구사항, 디자인, macOS 시스템 API를 병렬 조사하는 연구원 에이전트
clone Plan 컴퓨터 유즈나 브라우저를 통해 화면을 캡처하고 스크린 인덱스를 자동 생성
user-stories Plan 검증 가능한 인수 기준을 포함하여 마일스톤 단위의 작업 백로그(Backlog) 작성

사용자가 터미널 환경에서 어디서부터 시작해야 할지 모를 때 /bama 명령어를 호출하면, 시스템 라우터가 프로젝트의 현재 진행 상태(명세서 작성 단계, 인덱싱 완료 단계, 빌드 단계 등)를 판별하여 필요한 서브스킬을 스스로 트리거합니다. 이러한 오케스트레이션 메커니즘 덕분에 작업이 중단되더라도 이전 맥락을 잃지 않고 다음 마일스톤으로 넘어갈 수 있습니다.

"BAMA는 대규모 모델이 코딩할 때 발생하는 전형적인 환각과 설계 이탈을 방지하기 위해, 단계별 산출물이 디스크에 명시적인 파일(Specs, Backlog, Snapshot)로 기록된 후에만 다음 스킬로 제어권을 넘기도록 설계되었습니다."

템플릿 생성 스킬인 new-mac-app은 외부 의존성을 배제하고 애플의 최신 퍼시스턴스 프레임워크인 SwiftData를 기본 탑재합니다. 따라서 생성된 애플리케이션은 설치 즉시 외부 서버와의 통신 없이도 로컬 저장소에 안전하게 데이터를 쓰고 읽을 수 있는 견고한 샌드박스 구조를 확보하게 됩니다.


🚀 4. 실제 설치 및 네이티브 앱 생성 워크플로우

BAMA를 활용해 로컬 환경에서 네이티브 앱을 구축하는 과정은 Node.js 기반의 에이전트 스킬 매니저를 통해 몇 분 안에 시작할 수 있습니다. 시스템에 사전 요구되는 것은 최신 버전의 macOS 환경과 Swift 컴파일러가 포함된 커맨드라인 도구입니다.

터미널을 열고 다음의 명령어를 입력하여 전역 환경에 BAMA 스킬 세트를 추가합니다.

npx skills@latest add daveebbelaar/bama

설치가 완료되면 에이전트 세션(예: Claude Code 또는 호환 에이전트 인터페이스) 내에서 자연어로 작업을 지시할 수 있습니다. 예를 들어 특정 투두 앱을 네이티브로 복제하고 싶다면 다음과 같은 형태로 작업을 시작합니다.

"내가 사용 중인 투두 앱 화면을 캡처해서 네이티브 맥 앱으로 클론해 줘. 모든 화면을 캡처하여 스크린 인덱스를 만들고, 사용자 스토리를 작성한 다음 마일스톤 1을 빌드해 줘."

만약 프로젝트 도중 막히거나 현재 어떤 작업이 우선되어야 하는지 모호하다면, 다음과 같이 내장 라우터 명령어를 입력하여 현재 컨텍스트를 스캔하도록 합니다.

/bama

라우터는 작업 디렉터리를 스캔한 후 app-brief 작성이 필요한지, 혹은 clone 스킬을 통해 추가 스크린샷 수집이 필요한지를 스스로 판단하여 사용자에게 다음 단계를 제시합니다. 빌드가 시작되면 Swift 컴파일러가 백그라운드에서 동작하며, 생성된 컴파일 산출물과 스냅샷 이미지는 로컬 폴더에 차곡차곡 쌓여 개발자가 실시간으로 완성도를 육안 검증할 수 있습니다.

윈도우 환경 사용자들을 위해 저장소에서는 자매 프로젝트인 BAWA(Build Any Windows App)를 별도 대안으로 안내하고 있어, 플랫폼별로 분리된 네이티브 도구 체계를 지향하고 있음을 알 수 있습니다.


📊 5. 로컬 네이티브(SwiftData)와 웹 기반 래퍼의 본질적 차이

소프트웨어 아키텍처 관점에서 BAMA가 생성하는 애플리케이션의 가장 큰 미덕은 '로컬 퍼스트(Local-first)'와 '순수 네이티브 컴파일'이라는 두 가지 기둥 위에 서 있다는 점입니다. 지난 수년간 데스크톱 소프트웨어 시장을 지배했던 일렉트론 및 크로스플랫폼 솔루션들은 개발 생산성을 높여주었지만, 최종 사용자의 하드웨어에는 적지 않은 부담을 안겨주었습니다.

맥 앱 구현 방식별 성능 및 개발 비용 매트릭스
네이티브 완성도 및 반응 속도 (낮음 → 높음)
1사분면: 전통적 맥 개발
  • Xcode 수동 작업
  • 최고의 네이티브 완성도
  • 높은 학습 비용
2사분면: BAMA 에이전트
  • 에이전트 자동화
  • 순수 Swift 네이티브
  • 낮은 진입 장벽
3사분면: 크로스플랫폼 래퍼
  • 일렉트론 기반
  • 무거운 리소스 소모
  • 빠른 프로토타이핑
4사분면: 하이브리드 웹뷰
  • PWA 패키징
  • 시스템 통합 결여
  • 단순 웹 재배포
개발 장벽 (낮음 → 높음)
리소스 점유율과 개발 장벽에 따른 애플리케이션 구축 방식을 분류합니다.

일렉트론 기반 앱은 본질적으로 웹페이지를 구동하기 위한 독립된 크로미움(Chromium) 브라우저 인스턴스와 Node.js 런타임을 메모리에 띄우는 구조입니다. 텍스트 몇 줄을 입력하는 메모장이나 타이머 앱조차도 기본 수백 메가바이트의 램을 상시 점유하게 되며, 이는 기기의 발열과 배터리 수명 단축으로 직결됩니다.

반면 BAMA가 new-mac-app 스킬을 통해 구성하는 템플릿은 순수 Swift 언어로 컴파일되어 기계어 바이너리로 실행됩니다. 운영체제가 기본 제공하는 그래픽 렌더링 파이프라인(Metal)과 SwiftUI 레이아웃 엔진을 직접 활용하므로, 메모리 점유율이 극단적으로 낮고 창 크기 조절이나 애니메이션 전환 시 프레임 드롭이 거의 발생하지 않습니다.

여기에 애플이 도입한 차세대 데이터 지속성 프레임워크인 SwiftData가 결합됩니다. SwiftData는 복잡한 데이터베이스 설정이나 무거운 ORM 프레임워크 없이도 Swift 코드 내에서 선언적인 방식으로 스키마를 정의하고 로컬 SQLite 데이터베이스와 원활하게 상호작용합니다. 이는 사용자의 민감한 정보가 외부 클라우드 서버로 무단 전송되지 않고 개인 맥북 내부의 안전한 샌드박스 영역에만 온전히 보관됨을 의미합니다.


⚖️ 6. 저작권, UI 복제 윤리, 그리고 플랫폼 정책

BAMA와 같은 강력한 리버스 엔지니어링 도구가 보급됨에 따라 필연적으로 제기되는 문제는 소프트웨어 지식재산권과 디자인 복제에 따른 윤리적 충돌입니다. 기존 상용 앱의 스크린샷을 기계적으로 학습 및 분석하여 동일한 외형과 기능을 갖춘 소프트웨어를 찍어내는 행위는 법적·도덕적 논쟁을 촉발할 수밖에 없습니다.

일반적으로 소프트웨어의 사용자 인터페이스(UI) 레이아웃이나 기능적 아이디어 자체는 특허로 등록되어 있지 않은 한 저작권 보호의 대상이 되기 어렵습니다. 그러나 타사의 독창적인 그래픽 에셋(아이콘, 로고, 삽화), 고유한 브랜드 식별자, 독점적인 소스 코드 자체를 무단으로 추출하거나 배포하는 행위는 명백한 저작권 침해 및 부정경쟁방지법 위반에 해당할 위험이 높습니다.

따라서 BAMA를 올바르게 활용하는 방식은 타인의 상용 소프트웨어를 상업적으로 유통하기 위한 복제품(Rip-off)을 만드는 것이 아니라, 다음과 같은 건전한 기술적 목적에 집중되어야 합니다.

  1. 개인적 목적의 경량 대체재 구축: 과도한 구독료를 요구하거나 불필요한 기능이 비대해진 상용 앱에서 오직 내가 필요한 핵심 기능만을 발라내어 순수 로컬 유틸리티로 사용하는 경우
  2. 사내 레거시 도구의 네이티브 마이그레이션: 노후화된 사내 웹 도구나 단종된 소프트웨어의 인터페이스를 빠르게 네이티브 macOS 환경으로 재구축하는 엔지니어링 작업
  3. 인터랙션 프로토타이핑 가속화: 디자인 팀이 제작한 시안 스크린샷을 바탕으로 실제 동작하는 네이티브 프로토타입 바이너리를 하루 만에 완성하여 사용성을 검증하는 경우

기술의 발전이 모방의 비용을 0에 가깝게 만들수록, 개발자와 사용자는 지식재산에 대한 법적 경계를 자각하고 윤리적인 책임감을 갖고 도구를 운용해야 합니다.


⚠️ 7. 기술적 한계와 실무 도입 시 주의점

에이전트가 완성도 높은 네이티브 코드를 생성한다고 해서, 인간 엔지니어의 개입 없이 완벽한 상용 등급의 애플리케이션이 마법처럼 완성되는 것은 아닙니다. BAMA의 자동화 파이프라인 역시 실무 환경에서 마주하게 되는 몇 가지 분명한 기술적 장벽을 안고 있습니다.

첫째, 화면 캡처만으로는 파악할 수 없는 '숨겨진 상태(Hidden States)'와 복잡한 비즈니스 로직의 문제입니다. 네트워크 오류 처리, 엣지 케이스 데이터 검증, 백그라운드 동기화 실패 시 재시도 로직 등은 UI 스크린샷에 드러나지 않습니다. 에이전트가 이를 추론하여 작성하더라도 실제 프로덕션 환경에서 요구되는 견고함에는 미치지 못할 수 있습니다.

둘째, 시각적 일관성 검증을 위한 토큰 비용 문제입니다. BAMA는 커밋 전 라이트 모드와 다크 모드 스냅샷을 렌더링하고 이를 검증하는 과정을 거치는데, 멀티모달 LLM이 고해상도 이미지를 반복적으로 수신하고 분석하는 과정에서 상당한 API 비용과 지연 시간이 발생합니다.

7-1. 복잡한 시스템 권한과 서명 문제

맥 환경에서 유틸리티 앱이 제 성능을 발휘하려면 손쉬운 사용(Accessibility) 권한, 화면 기록 권한, 파일 시스템 전체 접근 권한 등 까다로운 권한 획득 절차가 수반됩니다. 그러나 에이전트가 생성한 스크립트는 macOS의 TCC(Transparency, Consent, and Control) 보안 프레임워크와 즉각적으로 충돌을 일으키기 쉽습니다.

더불어 정식 배포를 위해서는 애플 개발자 계정을 통한 코드 사이닝(Code Signing)과 공증(Notarization) 프로세스가 필수적입니다. BAMA가 로컬에서 컴파일한 바이너리는 게이트키퍼(Gatekeeper) 경고를 유발할 수 있으므로, 실무에서 안전하게 배포하고 실행하기 위해서는 최종 단계에서 개발자가 직접 보안 서명과 권한 엔타이틀먼트(Entitlements)를 점검해야 합니다.


🎯 8. 개인 맞춤형 소프트웨어 시대로의 진화

BAMA의 등장은 단순히 '앱을 쉽게 베끼는 도구'가 나왔다는 사실 이상의 의미를 지닙니다. 이는 소프트웨어의 생산과 소비 패러다임이 '대량 생산된 기성품 앱의 구독'에서 '개인 맞춤형 소프트웨어의 온디맨드 빌드'로 이동하고 있음을 알리는 신호탄입니다.

과거에는 화면 분할 도구나 클립보드 매니저, 미니멀한 메모장을 쓰기 위해 앱스토어를 뒤지고 월 3~5달러씩 정기 결제를 등록해야 했습니다. 하지만 이제는 내가 원하는 레이아웃과 동작 방식을 에이전트에게 텍스트와 이미지로 건네고, 내 하드웨어에 최적화된 경량 바이너리를 즉석에서 컴파일해 평생 무료로 안전하게 사용하는 시대가 열리고 있습니다.

AI 에이전트가 소프트웨어 아키텍처의 표준 템플릿을 이해하고, 시각적 피드백을 루프 삼아 자체적으로 테스트를 통과시키는 개발 방식은 향후 macOS를 넘어 모든 데스크톱 및 모바일 플랫폼으로 확산될 것입니다. BAMA는 그 미래가 결코 멀지 않았음을 증명하는 생생한 오픈소스 이정표입니다.

자주 묻는 질문

Q. BAMA를 실행하려면 Xcode가 반드시 설치되어 있어야 하나요?
A. 무거운 Xcode GUI 전체를 띄워 작업할 필요는 없지만, Swift 코드를 백그라운드에서 컴파일하기 위해 macOS 커맨드라인 개발자 도구(Command Line Tools)와 Swift 런타임 환경은 시스템에 갖추어져 있어야 합니다.

Q. 기존 앱의 소스 코드가 없어도 정말 화면 캡처만으로 복제할 수 있나요?
A. BAMA의 `clone` 스킬은 컴퓨터 유즈나 브라우저를 통해 화면을 캡처하고 스크린 인덱스를 만듭니다. 이를 기반으로 에이전트가 역으로 사용자 스토리와 요구사항을 추론하여 SwiftUI 코드를 새로 작성하는 방식이므로 원본 소스 코드가 없어도 동작합니다.

Q. 생성된 앱의 데이터는 안전하게 로컬에 저장되나요?
A. 네, BAMA의 `new-mac-app` 템플릿은 기본적으로 애플의 SwiftData 프레임워크를 탑재하도록 구성되어 있습니다. 데이터가 외부 클라우드로 전송되지 않고 사용자의 기기 내부 로컬 저장소에 격리 보관됩니다.

원본

https://github.com/daveebbelaar/bama

https://www.threads.com/@nangman_muk/post/DfHiLt2Aajp

함께 보면 좋은 글

댓글 0개