software-mansion/argent

Argent – 모바일, TV, 데스크톱 앱의 AI 기반 제어

정의

• AI 어시스턴트(예: ChatGPT, Claude)가 iOS 시뮬레이터, Android 에뮬레이터/기기, Apple/Android/Fire TV, Electron/Chromium 앱과 직접 상호작용할 수 있게 해주는 명령줄 도구입니다.
• 자연어 지시와 탭, 스와이프, 입력, 하드웨어 버튼 누름, 마우스/키보드 입력과 같은 UI 작업 사이의 간극을 메웁니다.

주요 기능

영역	Argent가 하는 일
상호작용	탭, 스와이프, 제스처, 입력, TV의 D-pad 내비게이션, 데스크톱 앱의 마우스/키보드 이벤트를 시뮬레이션합니다.
엔드투엔드 테스트	UI 작업 시퀀스를 한 번 녹화하고 버그 재현 또는 스모크 테스트를 위해 결정적으로 재생합니다.
시각적 회귀	스크린샷 기준선을 캡처한 다음 OCR 및 글꼴 인식 비교로 라이브 캡처와 비교합니다.
프로파일링	Hermes, React DevTools, Xcode Instruments, Perfetto에 연결하여 렌더링 타이밍, CPU 핫스팟, 멈춤 현상을 표시합니다.
디버깅	로그 스트리밍, 네트워크 트래픽 차단(XMLHttpRequest, axios, fetch, Expo), 앱 내 JS 평가, 네이티브/React 컴포넌트 트리 검사를 수행합니다.
React Native 지원	추가 구성 없이 RN 앱을 빌드, 실행, 반복할 수 있습니다.

사용 방법

# 프로젝트에서 도구 초기화 (npm 또는 pnpm)
npx @swmansion/argent@latest init   # pnpm: pnpm dlx @swmansion/argent@latest init

설치 후 AI 어시스턴트에게 다음과 같은 명령을 요청할 수 있습니다:

• “iPhone 시뮬레이터에서 로그인 버튼을 탭해.”
• “이 크래시를 재현하는 경로를 녹화해.”
• “홈 화면의 시각적 차이를 보여줘.” 어시스턴트는 자연어 요청을 적절한 CLI 호출로 변환하고 Argent가 대상 기기에서 실행합니다.

문서 및 개인정보 보호

• 전체 문서는 docs.swmansion.com/argent에서 제공되며 설치, 지원 플랫폼, CLI 참조, 편집기 통합을 다룹니다.
• 텔레메트리는 옵트아웃 가능합니다(argent telemetry disable). 수집되는 데이터에 대한 간단한 개인정보 보호 고지가 있습니다.

라이선스 모델

• 소스 코드는 Apache-2.0 라이선스입니다.
• 플랫폼별 바이너리(simulator-server, ax-service, .dylib 파일)는 Software Mansion의 독점 자산이며 Argent 내에서만 사용할 수 있습니다. 이러한 바이너리의 재배포 또는 리버스 엔지니어링은 금지됩니다.

개발 주체

• Software Mansion이 개발했습니다. 오랜 역사를 가진 에이전시이자 React Native의 핵심 기여자입니다. 컨설팅 및 맞춤 개발 서비스도 제공합니다.

혜택을 받을 수 있는 대상

• 모바일 또는 TV UI를 조작해야 하는 AI 기반 어시스턴트를 구축하는 팀.
• iOS, Android, 데스크톱에서 UI 흐름을 녹화하고 재생할 수 있는 단일 CLI를 원하는 QA 엔지니어.
• 프로그래밍 방식으로 구동할 수 있는 통합 프로파일링, 시각적 회귀, 디버깅 도구를 찾는 개발자.

---

모든 정보는 저장소의 README에서 직접 가져왔습니다.