앱을 뜯지 않고 속을 들여다보는 돋보기예요. 무엇을 보느냐에 따라 쓰는 법이 조금씩 달라요.
무엇을 들여다볼까요?
어떤 파일을 보든 이 준비는 같아요.
npx rea-agents setup바뀔 내용이 먼저 나와요. 확인하고 고르면 기존 설정은 백업돼요.
Claude Code 같은 에이전트를 껐다 켜면 끝이에요.
가장 쉬워요. 아래 칸마다 있는 말풍선 문장을 에이전트에게 그대로 보내도 돼요. 파일 경로만 바꾸세요.
아래 명령을 한 번 실행하면 rea 명령이 생겨요.
npm install --global rea-agents설치하기 싫으면 rea 대신 npx -y rea-agents@latest를 붙여 쓰세요.
필요한 것: Node.js 22.19 이상, 24.11 이상, 또는 26 이상과 npm.
그림으로 더 자세히설치와 설정
크롬에 열린 페이지를 옆에서 지켜봐요. 페이지는 건드리지 않아요.
9222 포트로 열어 둔 크롬 페이지에서 검색창이 어떤 서버 주소를 부르는지 REA로 조사하고 증거를 보여줘.
평소 쓰는 프로필과 따로 켜요. 맨 끝 주소를 보고 싶은 페이지로 바꾸세요. (Mac 기준)
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9222 --user-data-dir=/tmp/rea-browser-profile https://example.com열린 탭 목록이 나와요. 보고 싶은 탭의 id를 복사해 두세요.
rea list-browser-targets http://127.0.0.1:9222 --jsonTARGET_ID를 2번에서 찾은 id로 바꿔요. 화면 구조, 스크립트, 네트워크를 알려 줘요.
rea inspect-web-page http://127.0.0.1:9222 TARGET_ID --json자바스크립트를 실행하지 않고 읽기만 해서, 화면 경로와 API 주소 후보를 찾아요.
rea analyze-web-bundle http://127.0.0.1:9222 TARGET_ID --json명령을 실행하고 10초 안에 페이지를 직접 눌러 보세요. 그동안 일어난 이동과 새로고침을 기록해요.
rea observe-web-session http://127.0.0.1:9222 TARGET_ID --observation-ms 10000 --json그림으로 더 자세히웹페이지 관찰
Mac 앱 설치 파일을 열어 속을 봐요. 앱을 실행하지는 않아요.
~/Downloads/MyApp.dmg 안의 앱이 검색 기능을 어떻게 만들었는지 REA로 분석하고 증거를 보여줘.
REA가 DMG를 잠깐 열어 파일 목록을 만들고, 다시 닫아요.
rea inspect-artifact ~/Downloads/MyApp.dmg --json1번 결과에서 app.asar를 찾아보세요. 있으면 A, 없으면 B로 가요.
다음 단계 전에 DMG를 더블클릭해서 열어 두세요. /Volumes/MyApp 아래에 나타나요.
모듈, import, IPC 연결을 정리해 줘요.
rea analyze-javascript-application "/Volumes/MyApp/MyApp.app/Contents/Resources/app.asar" --jsonHopper가 앱을 읽고 함수와 글자(문자열)를 정리해요. .app을 그대로 넣으면 돼요.
rea analyze "/Volumes/MyApp/MyApp.app" --provider hopper --json궁금한 기능의 단어(예: search)로 관련 코드를 따라가요.
rea trace "/Volumes/MyApp/MyApp.app" "search" --provider hopper --jsonAPK 파일을 열어 코드를 읽어요. 앱을 실행하지 않으니 휴대폰이 없어도 돼요.
~/Downloads/app.apk에서 로그인을 처리하는 코드를 REA로 찾아서 설명해줘.
JDK 17 이상을 설치하고 JADX 파일을 받아요. 그다음 파일 위치를 알려 주면 돼요. 받는 방법은 아래 안드로이드 안내서에 있어요.
export REA_JADX_MCP_JAR="$HOME/.local/share/rea/android/jadx-headless-mcp-0.7.1-all.jar"패키지 이름, 요청하는 권한, 클래스 수를 알려 줘요.
rea inspect-android-package ~/Downloads/app.apk이름에 Login이 들어간 클래스를 찾아요. 찾는 단어만 바꾸면 돼요.
rea search-android-classes ~/Downloads/app.apk Login메서드를 자바 코드처럼 보여 줘요. 클래스 이름은 3번 결과에서 가져오세요.
rea inspect-android-method ~/Downloads/app.apk com.example.LoginActivity onCreate이 클래스를 쓰는 곳을 거꾸로 따라가요. 기능이 어디서 시작되는지 알 수 있어요.
rea trace-android-references ~/Downloads/app.apk com.example.LoginActivity그림으로 더 자세히안드로이드 APK
에이전트에 REA를 연결해요. 무엇을 바꿀지 먼저 보여 주고, 내가 승인해야 바꿔요.
npx rea-agents setup터미널에 한 줄 붙여넣고, 고르고, 확인하고, 다시 켜면 끝이에요.
npm이 먼저 패키지를 받아도 되는지 묻고, 그다음 REA가 설정을 바꿔도 되는지 따로 물어요.
npx rea-agents setup이미 REA가 연결된 에이전트는 미리 골라져 있어요. 새로 찾은 에이전트는 내가 직접 골라야 연결돼요.
바뀔 파일 경로가 모두 나와요. 승인하기 전에는 아무것도 바뀌지 않고, 언제든 취소할 수 있어요.
먼저 계획만 보고 싶으면 --dry-run을 붙여요. 읽기만 하고 바꾸지 않아요.
rea setup --client claude_code --dry-run완료 메시지에 이름이 나온 에이전트를 껐다 켜요. 그러면 REA 도구가 보여요.
순서 없이, 필요한 것만 골라 쓰면 돼요.
네이티브 앱을 볼 때만 필요해요. 자바스크립트 분석은 엔진 없이 돼요.
Hopper는 setup이 따로 물어본 뒤 설치해 줄 수 있어요. Ghidra는 직접 받아 두고 위치만 알려 주세요.
export GHIDRA_INSTALL_DIR=/absolute/path/to/ghidra_12.1.4_PUBLICdoctor는 읽기만 하고 아무것도 바꾸지 않아요. 전체 결과가 healthy가 아니어도, 내가 쓸 기능은 잘 될 수 있어요.
rea doctor --json하나만 확인하려면 범위를 골라요.
rea doctor --provider ghidra --jsonREA는 자주 바뀌어요. 전역으로 설치했다면 rea update로 올리고, 안내대로 setup을 한 번 더 승인하세요.
rea update지우기는 REA가 만든 등록과 스킬 파일만 지워요. Hopper, Node.js, 분석 결과는 그대로 둬요.
rea uninstall명령으로 바로 고를 때는 아래쪽 이름을 --client 뒤에 붙여요.
claude_codeclaude_desktopcodexcursorgemini_cliwindsurfdevinopencodeantigravitycopilot_clicommandcodeqwen_codekimivscodegrok_buildomppihermesqoderdroidtraeworkbuddyzcodedshdsh, kimi, workbuddy는 이들을 포함한 REA 버전이 있어야 해요.
이미 켜져 있는 브라우저에 살짝 붙어서 보기만 해요. 끝나면 자기 연결만 닫고 떠나요.
REA가 붙을 수 있도록 브라우저에 작은 문을 열어 줘요. 방법은 두 가지예요.
평소 쓰는 프로필과 따로 켜요. Chrome 136부터는 기본 프로필에서 이 포트 옵션이 무시되거든요. (Mac 기준)
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9222 --user-data-dir=/tmp/rea-browser-profile https://example.com브레이브, 크로미엄도 같은 두 옵션을 붙이면 돼요.
chrome://inspect/#remote-debugging에서 원격 디버깅을 켜요. 주소 끝의 id는 크롬 사용자 폴더의 DevToolsActivePort 파일에 있어요.
rea list-browser-targets ws://127.0.0.1:9222/devtools/browser/<id>연결할 때마다 크롬이 허락을 물을 수 있어요. 이 방법은 목록, 들여다보기, 스크립트 읽기, 지켜보기, WebMCP, 스크린샷만 돼요.
주소는 127.0.0.1 또는 [::1]만 받아요. localhost, 다른 컴퓨터 주소, https 주소는 안 돼요. 포트를 바깥에 열지 마세요.
목록에서 탭을 고르고, 한 장 기록하고, 스크립트를 읽고, 누르는 동안 지켜봐요.
열린 페이지마다 id가 나와요. --allowed-origins로 보고 싶은 사이트만 골라요. id는 브라우저를 다시 켜면 바뀌니 매번 새로 보세요.
rea list-browser-targets http://127.0.0.1:9222 --allowed-origins https://example.com --json화면 구조, 접근성 정보, 스크립트, 네트워크, 콘솔을 모아요. 기본은 0.5초 동안 지켜보고, 시간은 늘릴 수 있어요.
rea inspect-web-page http://127.0.0.1:9222 TARGET_ID --observation-ms 1000 --json실행하지 않고 읽기만 해요. 화면 경로, API 주소 후보, 쓰인 라이브러리를 찾아요. 소스맵이 필요하면 --fetch-source-maps를 붙여요.
rea analyze-web-bundle http://127.0.0.1:9222 TARGET_ID --json명령을 실행하고 정한 시간 안에 직접 눌러 보세요. 새로고침, 페이지 이동, 리다이렉트가 일어난 순서를 기록해요.
rea observe-web-session http://127.0.0.1:9222 TARGET_ID --observation-ms 10000 --json화면을 찍고, 두 번 찍은 것을 비교하고, 페이지가 AI에게 내놓은 도구를 찾아요.
지금 보이는 화면만 PNG로 찍어요. 부탁할 때만 찍어요.
rea capture-web-screenshot http://127.0.0.1:9222 TARGET_ID --json픽셀끼리 비교해요. 글자 인식이나 외부 서비스는 안 써요. 그림이 커서 명령줄 대신 JSON 파일로 넘겨요.
rea compare-web-screenshots before.json after.json전과 후의 기록을 비교해요. 빠지거나 잘린 정보가 있으면 "같다"고 하지 않아요.
rea compare-web-captures before.json after.json페이지가 AI용으로 등록한 도구 이름과 입력 형식을 보여 줘요. 도구를 실행하지는 않아요. 브라우저가 지원하지 않으면 unavailable이라고 나와요.
rea discover-webmcp-tools http://127.0.0.1:9222 TARGET_ID --json기본으로는 꼭 필요한 것만 기록해요. 더 보고 싶은 것만 하나씩 켜요. 모두 처음엔 꺼져 있어요.
--include-accessibility-text버튼·링크의 이름과 설명 글--include-console-text콘솔에 찍힌 글자--include-json-body-shapesJSON 응답의 모양 (경로·종류·개수만, 값은 빼고)--include-websocket-shapes웹소켓 메시지의 모양--include-script-sources스크립트 원문--include-storage-keys저장소의 키 이름 (값은 늘 가려요)--include-storage-fingerprints저장소 내용의 지문(SHA-256), 비교할 때 써요rea inspect-web-page http://127.0.0.1:9222 TARGET_ID --include-accessibility-text --include-console-text --include-json-body-shapes --include-websocket-shapes --include-script-sources --include-storage-keys --include-storage-fingerprints --json조심하세요. 화면 글자, 스크립트, 콘솔 글자에는 비밀이 들어 있을 수 있고, 켜면 결과에 그대로 남아요. 필요할 때만 켜세요.
REA는 기록을 내 컴퓨터에만 남기고, 몇 가지는 처음부터 버려요.
REA는 지붕을 열고 방마다 무엇이 있는지 지도를 그려요. 앱을 실행하지는 않아요.
~/Downloads/MyApp.dmg 안의 Mac 앱 구조를 REA로 그려 주고, 들어 있는 헬퍼와 로그인 항목을 알려줘.
Mac 앱은 MyApp.app이라는 집이고, 실제 살림은 Contents/ 안에 있어요.
Info.plist앱의 이름표. 실행 파일 이름과 번들 ID가 적혀 있어요.Contents/MacOS/실행 파일이 사는 방. 앱의 주인공이에요.*.framework앱이 빌려 쓰는 부품 묶음이에요.Contents/Helpers/옆에서 일을 돕는 작은 프로그램이에요.PlugIns/*.bundle · *.plugin기능을 끼워 넣는 플러그인이에요.*.appex앱 밖에서 동작하는 앱 확장이에요.*.xpc따로 떠서 일을 맡는 XPC 서비스예요.Library/LoginItems/*.app로그인할 때 함께 켜질 수 있는 앱이에요.Library/LaunchAgents · LaunchDaemons자동 실행 설정(.plist)이에요. Agents는 사용자용, Daemons는 시스템용이에요.Library/LaunchServices/관리자 권한으로 도는 특권 헬퍼(SMJobBless)가 있는 곳이에요.REA는 먼저 "어디부터가 앱인지"를 정해요. 색칠된 곳이 앱의 뿌리예요.
Payload/ 안의 각 .app이 뿌리예요.
넣은 폴더 그 자체가 뿌리예요.
Contents/가 있는 가장 바깥 .app이 뿌리예요.
디스크 이미지 안 볼륨의 .app이 뿌리예요. 속을 보려면 Mac에서 열 수 있어야 해요.
파일마다 경로와 해시를 적은 목록(inventory)을 만들어요. 결과는 파일로 저장해 두세요.
rea inspect-artifact ~/Downloads/MyApp.dmg --json > inspection.json<inventory_artifact Evidence> 자리에 1번 결과의 inventory Evidence를 넣어요. 같은 내용을 담은 JSON 파일 경로를 줘도 돼요.
rea project-apple-application-graph '{"inventory_evidence":[<inventory_artifact Evidence>]}'지도는 plist 내용을 읽지 않아요. 실행 파일 이름, 번들 ID, URL scheme, 권한 설명은 이 명령으로 봐요.
rea inspect-plist /Applications/MyApp.app실행 파일의 코드 서명 정보를 봐요.
rea inspect-signature /Applications/MyApp.app/Contents/MacOS/MyApp실행 파일이 어떤 라이브러리 파일을 불러오는지 따라가요. 실행하지 않으니 Mac이 아니어도 돼요.
rea trace-dylib-resolution /Applications/MyApp.app --json폴더 이름이 정확히 맞을 때만 "Flutter 같아요" 하고 알려 줘요. 정말 쓰였는지는 증명하지 않아요.
같은 앱 안의 스크립트와 네이티브 파일을 경로로 짝지어 보여 줘요. 너무 많으면 앞부분만 싣고, 빠진 개수를 알려 줘요.
목록을 다 받았으면 complete, 일부만 받았으면 partial이에요. partial일 때 "없다"는 "모른다"는 뜻이에요.
컴퓨터만 읽는 0과 1 프로그램을 사람이 읽을 수 있는 모양으로 풀어 봐요.
사람이 쓴 코드를 컴퓨터용 0과 1로 바꿔 둔 파일이에요. 우리 손에는 보통 가운데 것만 있어요.
풀어 쓴 코드는 원래 코드와 똑같지 않아요. 엔진이 0과 1을 보고 다시 만들어 낸 모양이라, 이름이 f1처럼 바뀌어 있을 수 있어요.
REA는 이미 설치된 분석 엔진을 빌려 써요. 셋 중 하나만 있으면 돼요.
따로 파는 프로그램이에요. 제한이 있는 무료 데모가 있어요. 처음 준비할 때 설치를 제안받을 수 있어요.
분석할 때마다 임시 데이터베이스를 만들어 써요. 프로그램 파일은 바뀌지 않아요.
이미 가진 IDA와 IDA MCP 서버를 연결해요. 열려 있는 IDA 데이터베이스는 저장하거나 닫지 않아요.
rea providers --jsonrea doctor --provider ghidra --jsonexport REA_ANALYSIS_PROVIDER=ghidra명령에 --provider를 붙이면 그쪽이 먼저예요.
큰 지도에서 시작해 한 기능까지 좁혀 가요. 아래는 Ghidra 예시예요. Hopper를 쓰면 --provider hopper로 바꾸세요.
프로그램이 어떤 덩어리로 되어 있고 함수가 얼마나 있는지 훑어봐요. Mac 앱은 .app을 그대로 넣어도 돼요.
rea analyze /path/to/program --provider ghidra --json궁금한 기능과 관련된 단어로 함수나 글자를 찾아요.
rea search /path/to/program "search" --provider ghidra --json함수 하나가 무엇을 부르고, 어떤 글자를 쓰는지 한 장에 모아 봐요. 이름은 1·2번 결과에서 그대로 가져오세요.
rea function /path/to/program main --provider ghidra --json기계어를 C 코드와 비슷한 모양(의사코드)으로 바꿔 보여 줘요. 이름이나 주소를 넣어요.
rea decompile /path/to/program 0x1000 --provider ghidra --json이 주소를 부르거나 쓰는 다른 곳을 모아 줘요.
rea xrefs /path/to/program 0x1000 --provider ghidra --json단어 하나에서 출발해 관련 함수들을 이어서 따라가요.
rea trace /path/to/program "search" --provider ghidra --json시작 함수 이름이 꼭 main이나 entry인 건 아니에요. 앞 단계 결과에 나온 이름과 주소를 그대로 쓰세요. 이름이 -로 시작하면 '--procedure=-[REAWidget delegate]'처럼 등호를 붙여 써요.
한 번 얻은 답을 파일로 남겨 두면, 다음에는 기다리지 않고 바로 꺼내 써요.
같은 명령을 같은 파일 경로로 다시 실행하면 저장된 답을 바로 써요. 파일은 내 컴퓨터에만 남아요.
rea analyze /path/to/program --provider ghidra --snapshot /path/to/analysis/program.jsonREA가 남긴 증거(Evidence) 파일 두 개를 나란히 놓고 달라진 점을 찾아요. 파일이 올바른지만 보려면 rea evidence-import를 써요.
rea compare /path/to/left.json /path/to/right.jsonJADX라는 번역기로 APK 속 코드를 사람이 읽는 자바 코드로 바꿔 봐요. 앱은 실행하지 않아요.
REA는 Java와 JADX를 대신 설치하지 않아요. 직접 놓아 두고 위치만 알려 줘요.
JDK 17 이상이 필요해요. 실행만 하는 JRE로는 안 돼요. 나오는 목록에 jdk.compiler가 보이면 통과예요.
java --list-modules받은 파일의 SHA-256 값이 REA에 적힌 값과 같아야 해요. 아래 명령은 받기, 확인, 위치 알려 주기까지 한 번에 해요.
MAC · LINUX
mkdir -p "$HOME/.local/share/rea/android" &&
cd "$HOME/.local/share/rea/android" &&
curl -fL -o jadx-headless-mcp-0.7.1-all.jar https://github.com/1013503897/jadx-headless-mcp/releases/download/v0.7.1/jadx-headless-mcp-0.7.1-all.jar &&
if command -v sha256sum >/dev/null; then
echo '6e5eacf500b64292bfb73c49797c1958f6ee44646e43e868039ae7feb573ff75 jadx-headless-mcp-0.7.1-all.jar' | sha256sum -c -
else
echo '6e5eacf500b64292bfb73c49797c1958f6ee44646e43e868039ae7feb573ff75 jadx-headless-mcp-0.7.1-all.jar' | shasum -a 256 -c -
fi &&
export REA_JADX_MCP_JAR="$PWD/jadx-headless-mcp-0.7.1-all.jar"WINDOWS POWERSHELL
$jar = Join-Path $HOME '.local\share\rea\android\jadx-headless-mcp-0.7.1-all.jar'
New-Item -ItemType Directory -Force (Split-Path $jar) | Out-Null
Invoke-WebRequest -Uri 'https://github.com/1013503897/jadx-headless-mcp/releases/download/v0.7.1/jadx-headless-mcp-0.7.1-all.jar' -OutFile $jar
if ((Get-FileHash -Algorithm SHA256 $jar).Hash.ToLowerInvariant() -ne '6e5eacf500b64292bfb73c49797c1958f6ee44646e43e868039ae7feb573ff75') { throw 'JADX JAR SHA-256 does not match REA pinned metadata' }
$env:REA_JADX_MCP_JAR = $jar2번을 실행한 터미널에서는 이미 끝났어요. 새 터미널이나 에이전트(MCP 서버) 설정에도 같은 값을 넣어 주세요.
export REA_JADX_MCP_JAR=/absolute/path/jadx-headless-mcp-0.7.1-all.jar
# 선택: PATH의 java 대신 특정 JDK를 쓰고 싶을 때
export JAVA_HOME=/absolute/path/existing-jdk큰 그림에서 작은 코드 한 줄까지, 다섯 걸음이에요.
패키지 이름, SDK, 권한, 클래스와 리소스 수를 알려 줘요. 서명이 진짜인지는 검사하지 않아요.
rea inspect-android-package ~/Downloads/app.apk이름 일부로 찾아요. 같은 이름이 여러 번 나오면 숨기지 않고 모두 보여 줘요.
rea search-android-classes ~/Downloads/app.apk MainActivity필드와 메서드 목록을 보여 줘요. 이름이 같은 메서드는 번호(0, 1…)로 구별해요. 이 단계에서는 코드를 아직 만들지 않아요.
rea inspect-android-class ~/Downloads/app.apk com.example.MainActivity자바 코드로 보여 줘요. 같은 이름이 여럿이면 REA는 마음대로 고르지 않고 멈춰요. 3번에서 본 번호를 --overload-index로 넣으세요.
rea inspect-android-method ~/Downloads/app.apk com.example.MainActivity onCreaterea inspect-android-method ~/Downloads/app.apk com.example.MainActivity select --overload-index 1번호는 이 APK와 이 JADX에서만 통해요. 다른 빌드에서는 달라질 수 있어요.
이 클래스나 메서드를 가리키는 곳을 찾아요. 코드에 적힌 관계일 뿐이에요. 실행 중에 정말 불렸다는 뜻은 아니에요.
rea trace-android-references ~/Downloads/app.apk com.example.MainActivityrea trace-android-references ~/Downloads/app.apk com.example.MainActivity --method-name onCreate무엇을 알 수 있고, 무엇은 아직 모르는지 나눠서 봐요.
코드가 끝까지 다 나와도, 원본과 똑같다는 뜻은 아니에요. 디컴파일러가 다시 만들어 낸 모습이에요.
궁금한 것이 코드가 아니라면 이쪽이 더 빨라요.
Apktool 2.7.0 이상이 있으면 앱 속 문자열과 언어별 번역을 풀어 줘요.
rea decode-android-resources ~/Downloads/app.apk도구를 설치하지 않아도 Dart 빌드 정보와 라이브러리 지문을 알려 줘요.
rea identify-flutter-build ~/Downloads/app.apkadb로 연결된 기기를 볼 때 써요. 먼저 adb가 준비됐는지 확인해요.
rea inspect-adb-client