morluto/rea

English · 简体中文 · 日本語 · 한국어 · العربية

좋아하는 기능을 발견했나요? 그것이 어떻게 작동하는지, 바이너리 레벨까지 이해해 보세요.

문서(Documentation) · 빠른 시작(Quick start) · 현재 상태(Current status) · 조사 모델(Investigation model) · 도구 카탈로그(Tool catalog) · 로드맵(Roadmap) · 작동 방식(How it works)

npx rea-agents setup

리버스 엔지니어링 커뮤니티에 참여하세요
Discord · Q&A · Show and Tell
|

앱에서 자신의 제품에 넣고 싶은 기능을 발견했나요? 에이전트에게 REA를 사용하여 조사하도록 요청하세요. REA는 소스 코드 없이도 앱을 검사하고, 기능 작동 방식을 설명하며, 증거를 보여주고, 프로젝트용 버전을 구축할 수 있습니다.

REA는 에이전트를 네이티브 바이너리, JavaScript 및 Electron 앱, .NET 어셈블리, 그리고 웹사이트를 검사하는 도구에 연결합니다. 또한 터미널에서 동일한 도구를 사용할 수 있습니다. 분석은 로컬에서 실행되며, 결과에는 각 결론의 증거와 한계가 포함됩니다.

설정(Setup)은 REA를 에이전트에 등록하고 일치하는 워크플로우 지침을 설치합니다. 네이티브 분석은 기존 Hopper 또는 Ghidra 설치를 사용할 수 있으며, 설정 시 승인을 통해 선택적으로 Hopper를 설치할 수 있습니다. 정적 JavaScript 분석에는 엔진이 필요하지 않습니다.

에이전트에 REA 설정하기:

npx rea-agents setup

어떤 지원 에이전트가 REA를 사용해야 하는지 선택한 다음, 승인하기 전에 정확한 경로와 변경 사항을 검토하세요. 기존 REA 등록은 기본적으로 선택되며, 새로 감지된 에이전트는 선택할 수 있지만, 감지만으로는 자동으로 선택되지 않습니다. 설정은 MCP 접근 및 선택된 에이전트를 위한 REA의 안내형 워크플로우를 추가합니다. Hopper는 자체 동의가 필요한 별도의 선택 사항입니다. 설정은 또한 기존 Ghidra 설치를 기록할 수도 있습니다.

설정은 적용하기 전에 변경 사항을 보여주고 기존 구성을 백업합니다. 요구 사항 및 설정 옵션은 설치(Installation) 및 설정(setup)을 참조하세요.

더 풍부한 컨텍스트를 위해 AI 코딩 어시스턴트에 스킬 추가하기:

npx skills add morluto/rea --skill reverse-engineer-anything

이 스킬은 REA의 조사 워크플로우를 제공합니다. 위의 설정을 실행하여 REA를 에이전트에 연결하고 분석 도구를 구성하세요. 설정 시 기본적으로 버전이 일치하는 스킬이 설치되지만, 이 명령어는 리포지토리 버전을 설치합니다.

설정 후에는 에이전트를 재시작하고 이해하고자 하는 앱이나 기능을 설명하면 됩니다. Hopper는 데모 모드로 실행할 수 있습니다. 만약 첫 실행 프롬프트가 표시되면, '데모'를 선택하거나 기존 라이선스를 입력하세요.

REA는 Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, Windsurf, Devin, OpenCode, Antigravity, GitHub Copilot CLI, Command Code, 그리고 VS Code를 지원합니다. 기존 REA 등록은 설정 중에 기본적으로 선택되며, 다른 감지된 에이전트는 선택되지 않은 상태로 유지되다가 사용자가 직접 선택해야 합니다. 다른 에이전트는 수동 MCP 구성을 사용할 수 있습니다.

추출한 JavaScript/Electron 애플리케이션 트리 또는 ASAR의 경우 다음을 실행하세요:

npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json

경로를 대상 경로(예: Windows의 경우 `

여전히 전체 감사(audit) 내용을 요약합니다. --target

대상 검사를 추가하지만, 범위 옵션이 없으면 보고서는 여전히 감사 전반에 걸쳐 유지됩니다.

설치된 엔진 중 하나 이상이 네이티브 대상(native target)을 지원하는 경우, REA는 하나를 선택하지 않습니다. 대상을 열려고 하면 code: "capability_unavailable",
details.selection_reason: "ambiguous",
그리고 details.candidate_ids에 있는 제공자들로 인해 실패합니다. 한 번만 선택하세요: CLI에서 --provider를 사용하거나, open_binary에서 provider_id를 사용하거나, 또는 REA_ANALYSIS_PROVIDER를 영구적인 기본 설정으로 지정하세요. 명시적 선택자가 환경 변수를 덮어씁니다. 세션은 그 선택을 유지하며 다른 엔진으로 되돌아가지 않습니다. 복구는 details.selection_reason에 따라 달라집니다. ambiguous의 경우, 후보 중 하나를 선택하세요. provider_unavailable의 경우, 선택한 엔진에 수리가 필요하므로 rea doctor --provider <id> --json을 실행하고 그 해결책을 따르세요. 이러한 이유들은 모든 엔진을 설치해야 함을 의미하지는 않습니다. 심층 분석 제공자 선택(Choosing a deep-analysis provider)을 참조하세요.

명령줄 인터페이스를 설치하세요:

curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash

설치 프로그램은 rea를 시스템에 추가하고 터미널에서 실행할 때 설정을 시작합니다. 이미 Node.js와 npm이 설치되어 있어야 합니다.

또는, npm으로 설치한 다음 설정을 실행하세요:

npm install --global rea-agents
rea setup

rea update로 두 설치 모두를 업데이트하세요.

정적 JavaScript 검사는 Node/npm 런타임만 필요합니다. 호스트 및 외부 도구 전제 조건은 선택한 워크플로우에 따라 달라지며, 네이티브 제공자 가이드가 지원되는 플랫폼을 설명합니다.

• macOS 12 이상
• Ubuntu 24.04+, Fedora 41+, 또는 64비트 Arch Linux
• Node.js 22.x (>=22.19), 24.x (>=24.11), 또는 26+
• npm; REA는 특정 npm 버전을 요구하거나 설치하지 않습니다.

딥 네이티브 바이너리 분석을 위해서는 Hopper, Ghidra 또는 IDA Pro가 필요합니다. Hopper는 자체 라이선스를 가진 별도의 소프트웨어이며, 데모 버전은 공급업체 정의 제한 내에서 분석을 지원합니다. Ghidra와 IDA는 사용자가 직접 제공하는(bring-your-own) 방식입니다.

펌웨어 영역 검사 및 명시적 추출에는 Linux 환경에서 호출자(caller)-제공 Binwalk와 Unblob을 사용합니다. 설정, 출처(provenance), 리소스 제한 및 네이티브 핸드오프에 대해서는 펌웨어 분석(Firmware analysis)을 참조하십시오.

정적 APK 분석은 별도로 제공되는 헤드리스 JADX JAR 파일과 전체 JDK를 사용하며, 에뮬레이터나 APK 실행 과정은 없습니다. 설정, CLI/MCP 작업, 커버리지 및 공개 테스트 구조체에 대해서는 안드로이드 분석(Android analysis)을 참조하십시오. 인증된 IPA 인벤토리 증거(Evidence)는 Apple 애플리케이션 분석을 통해 투영할 수 있습니다.

Repository의 main과 npm 4.1.0에는 로컬 NTFS 환경의 네이티브 x86-64 PE 애플리케이션에 대한 실험적인 Windows x64 Ghidra 지원이 포함되어 있으며, 여기에는 번들된 Job Object, private-DACL 및 path-admission 제어 기능이 있습니다. 이전 npm 패키지에서 이를 기대하기 전에 릴리스 경계를 확인하십시오. 전제 조건과 검증된 범위에 대해서는 Windows Ghidra P0을 참조하십시오.

만약 작동하지 않는 부분이 있다면 다음 명령어를 실행하십시오:

npx -y rea-agents@latest doctor

doctor는 사용자의 호스트, 종속성(dependencies), 분석 도구 및 에이전트 구성을 변경하지 않고 검사합니다. 구조화된 진단 결과를 원한다면 --json을 사용하십시오.

macOS에서는 승인 후 setup을 통해 ~/Applications에 Hopper를 설치할 수 있습니다. 이는 공식 다운로드를 확인하며 Homebrew나 관리자 권한이 필요하지 않습니다.

지원되는 Linux 배포판에서는 setup을 통해 시스템 패키지 관리자를 이용하여 Hopper와 그 데모 세션 종속성을 설치할 수 있습니다. 시스템 승인 프롬프트가 나타날 수 있습니다. 데모 세션은 사설 가상 디스플레이를 사용하므로 바탕화면에는 영향을 주지 않습니다. 다운로드 확인 및 플랫폼 세부 정보에 대해서는 Hopper 설치(Hopper installation)를 참조하십시오.

일반적인 Linux 런처 경로는 /opt/hopper/bin/Hopper입니다. 만약 Hopper가 다른 곳에 설치되었다면:

export HOPPER_LAUNCHER_PATH=/absolute/path/to/Hopper
rea doctor --json

만약 doctor가 파일이 존재함에도 불구하고 누락된 분석 엔진을 보고한다면, 다음 명령어로 shared-library resolution을 확인하세요:

ldd /opt/hopper/bin/Hopper | grep 'not found'

누락된 패키지를 설치하고 rea setup을 다시 실행하세요.

. Linux 데모는 Xvfb, Python 3, X11, 그리고 XTEST가 필요하며, 승인된 설정은 이러한 종속성을 설치합니다. curl 설치 프로그램을 사용하는 경우, 필요할 때 ~/.local/bin을 셸의 PATH에 추가하세요.

REA는 macOS에서는 기본적으로 HOPPER_LAUNCHER_PATH를 /Applications/Hopper Disassembler.app/Contents/MacOS/hopper로, Linux에서는 /opt/hopper/bin/Hopper로 설정합니다. 명시적 구성이 항상 우선권을 가집니다.

이미 Ghidra를 사용하고 있나요? REA는 Linux x64 또는 macOS x64/arm64의 에이전트에 연결할 수 있습니다. Ghidra 12.1.x와 설치가 선언하는 64비트 전체 JDK( application.java.min부터 application.java.max까지)를 지원합니다. 현재 12.1 릴리스는 JDK 21 이상을 요구하며 최대값을 설정하지 않습니다. 브릿지는 Ghidra 12.1.4 및 JDK 21로 검증되었습니다. macOS의 경우, Ghidra 설치에 아키텍처별 네이티브 디컴파일러가 포함되어야 합니다.

설치 경로를 설정한 다음 setup을 실행하세요:

export GHIDRA_INSTALL_DIR=/absolute/path/to/ghidra_12.1.4_PUBLIC
export JAVA_HOME=/absolute/path/to/jdk-21 # java와 javac가 PATH에서 해결될 경우 선택 사항
ea doctor --json
...

Setup은 설치를 확인하고 승인 후 해당 경로를 사용자가 선택한 에이전트의 구성에 저장합니다. Ghidra와 Java는 이미 설치되어 있어야 하며, REA가 다운로드하거나 변경하지는 않습니다.

어댑터는 인벤토리(inventory), 함수(function), 메모리 및 로드-이미지 검사 기능 외에도 Linux와 macOS에서 원자적 함수 주석 편집 기능을 제공합니다. annotate_native_function은 세션 데이터베이스의 이름과 진입점 주석을 수정하고 새로 고침된 함수 도서(dossier)를 반환하며, 실행 가능한 바이트는 변경되지 않습니다. Ghidra는 REA를 통해 GUI 제어 기능을 제공하지 않습니다.

Ghidra 타겟을 열면 해당 제공자(provider)가 선택되며, 첫 번째 분석 쿼리가 임포트 및 자동 분석을 시작합니다. 이 쿼리는 클라이언트의 기본 요청 마감 시간보다 오래 걸릴 수 있습니다. SDK 예제와 취소 복구에 대한 첫 번째 쿼리 마감 시간 및 복구 기능을 참조하십시오.

REA는 타겟의 임시 사본을 분석하고 세션이 종료되면 임시 프로젝트를 제거합니다. 결과는 Ghidra가 관찰한 것과 해결할 수 없었던 것을 식별합니다. 디컴파일은 원본 소스 대신 의사 코드(pseudocode)를 생성합니다.

Ghidra는 명시적인 16비트 x86 실 모드 프로필을 사용하여 DOS MZ 실행 파일도 임포트합니다. 함수 결과에는 완전히 관찰된 본문 범위가 포함되며, 소유된 바이트와 이를 둘러싸는 영역(span)을 구별합니다. 주소, 패킹 및 검증 경계에 대해서는 DOS 분석 가이드를 참조하십시오. 고정된 헤드리스 어댑터의 선택적 NativeAOT 메타데이터 복구, 지원 레이아웃 및 기존 네이티브 도구 워크플로우에 대해서도 참조하십시오.

Windows Ghidra P0은 로컬 NTFS상의 읽기 전용 네이티브 x86-64 PE 경계를 위해 번들된 네이티브 컨트롤을 사용합니다. Windows Ghidra P0 가이드를 참조하십시오. 구성 세부 정보, 커버리지 및 실제 제공자 검증에 대해서는 Ghidra 설치, 제공자 평가 및 테스트를 참조하십시오.

REA가 소유한 MCP 등록과 관리 스킬만 제거하려면:

rea uninstall
rea uninstall --purge-data # ~/.rea/cache와 ~/.rea/state도 함께 제거합니다

제거(Uninstall)는 Hopper, Node.js, Evidence 파일, 캡처, 관련 없는 스킬 및 기타 MCP 서버를 보존합니다. 잘못된 클라이언트 구성은 거부하며 purge-data 심볼릭 링크를 절대 따르지 않습니다.

이미 mrexodia/ida-pro-mcp가 작동하고 있습니까? REA는 현재 GUI 타겟의 읽기 전용 분석을 위해 해당 MCP 등록을 재사용하거나, 데이터베이스 감독관(database supervisor)을 사용하여 공급된 바이너리를 헤드리스로 열고 분석할 수 있습니다.

export REA_IDA_MCP_CONFIG=/absolute/path/to/ida-mcp.json
rea function /absolute/path/to/program main --provider ida --json

등록은 attached (기본값, 레거시 1.4 도구) 또는 headless를 선택합니다.

(현대적인 데이터베이스 슈퍼바이저). 설정은 선택한 에이전트의 REA 등록에 이 파일 참조를 보존할 수 있습니다. REA는 기존 분석 계약을 조정하고 자체 헤드리스(headless) 데이터베이스를 관리하며, 첨부된 GUI 데이터베이스는 열어두고 절대 저장하지 않습니다. 외부 IDA 데이터베이스 변경 사항은 불변 스냅샷이 아니기 때문에 결과가 실시간으로 유지됩니다.

IDA 제공자 가이드에서 상위 설치 링크, 정확한 구성 예시, Windows 네이티브 헤드리스 작동 방식, 라이프사이클 정리 및 커버리지를 확인하세요. 초기 실제 워크플로우는 Windows GUI와 Windows x64 헤드리스 IDA 9.3을 다룹니다. 다른 엔진/플랫폼 조합은 아직 검증되지 않았습니다. 이 어댑터를 포함하는 패키지 버전을 사용하십시오. 레포지토리의 main 브랜치가 npm 출시를 주도할 수 있습니다.