REA 사용법: 메모 저장 버튼 하나로 배우는 첫 리버스 엔지니어링
공식 메모 예제로 설치·연결·정적 분석·CSV 확인까지 6단계를 따라가요. 예상 결과와 실제 실행 확인의 차이도 설명해요.
마지막 업데이트
메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.
REA를 처음 접했다면 큰 실행 파일보다 저장 버튼 하나의 행방부터 찾아보면 좋아요. 이번 목표는 공식 메모 예제에서 내보내기 버튼이 어떤 코드를 거쳐 어느 파일을 만드는지 설명하고, 쉼표·따옴표가 들어간 메모 제목을 제대로 저장하는지 확인하는 거예요.
이 글은 REA 6.7.0의 문서와 공식 예제 코드를 기준으로 작성한 따라 하기 안내예요. 아래 REA 분석 결과는 개발자의 기록과 코드에서 기대할 수 있는 내용이며, 제가 REA를 설치해 얻은 실행 보고서는 아니에요. REA 원리 해설을 먼저 읽어도 좋고, 필요한 준비부터 바로 따라가도 좋아요.
준비물과 완료 기준
공식 예제는 Electron으로 만든 작은 메모 앱이에요. Electron은 웹 기술로 데스크톱 앱을 만드는 도구예요. 이번 파일 분석과 CSV 함수 확인에는 Electron 앱을 설치하거나 실행할 필요가 없어요. 앱 화면을 직접 띄워 저장하는 전체 과정은 별도 실행 확인이에요.
| 필요한 것 | 이번에 쓰는 이유 |
|---|---|
| Node.js와 npm | REA와 작은 JavaScript 함수를 실행해요. |
| 로컬 도구를 사용할 수 있는 코딩 에이전트 | 파일 경로를 받아 REA를 호출하고 결과를 설명해요. |
| 공식 notes-example ZIP | 분석 권한과 질문 범위가 분명한 연습 자료예요. |
| 별도 연습 폴더 | 내 프로젝트와 예제 파일을 구분해요. |
완료 기준은 세 가지예요. 저장 경로를 만드는 코드 찾기, 제목에 따옴표가 있을 때의 CSV 결과 설명하기, 실제 확인한 범위를 기록하기예요. “분석 성공”이라는 문구만 나오면 끝내지 말고 이 세 가지 답이 있는지 봐주세요.
1. Node.js 버전과 명령 창을 확인해요
Node.js는 JavaScript 코드를 실행하는 환경이고, npm은 필요한 패키지를 받는 데 쓰는 도구예요. npx는 그 패키지의 명령을 실행할 때 사용해요. 이름이 비슷해도 역할이 조금씩 달라요.
Windows는 PowerShell, macOS는 터미널, Linux는 사용하는 터미널을 열어요. 다음 두 줄은 AI 대화창이 아니라 명령 창에 입력해요.
node -v
npm -v
REA 6.7.0의 Node.js 조건은 22.x에서 22.19.0 이상, 24.x에서 24.11.0 이상, 또는 26 이상이에요. 숫자가 크다는 이유로 23·25 버전을 고르는 방식은 지원 조건에 맞지 않아요. 필요한 경우 Node.js 공식 사이트에서 지원되는 버전을 준비한 뒤 명령 창을 다시 열어요.
PowerShell에서 npm이나 npx 실행 시 스크립트 제한 오류가 나오면 공식 안내처럼 npm.cmd, npx.cmd를 사용해볼 수 있어요. 이 예제를 위해 시스템 전체 보안 설정을 바꿀 필요는 없어요.
2. REA를 사용할 에이전트에 연결해요
이미 사용 중인 코딩 에이전트가 있다면 아래 명령으로 이번 글의 기준 버전을 선택할 수 있어요.
npx rea-agents@6.7.0 setup
공식 문서의 최신판 설치 명령은 npx rea-agents@latest setup이에요. 위 명령은 설명과 버전을 맞추기 위해 6.7.0을 지정한 형태예요. 나중에 최신판으로 따라갈 때는 바뀐 요구사항과 출력 형식을 함께 확인해요.
설치 과정에서 연결할 에이전트를 고르고, 수정할 설정 파일과 추가할 조사 절차를 확인해요. npm의 패키지 다운로드 확인과 REA의 설정 변경 확인은 서로 다른 단계예요. 선택한 에이전트를 완전히 다시 시작한 뒤 “REA 도구가 연결됐는지 확인해줘”라고 요청해요.
MCP 연결은 AI가 도구를 호출할 수 있게 하고, 함께 설치되는 skill은 조사 순서를 안내해요. 안내문만 있어도 실제 분석 도구가 연결된 것은 아니에요. 명령 창만 쓰는 독자는 이 에이전트 연결을 생략하고 4단계의 CLI 분석 명령을 사용할 수도 있어요.
3. 공식 예제를 별도 폴더에 풀어요
공식 메모 예제 ZIP을 내려받아 압축을 풀어요. notes-example 폴더 안에서 package.json, main.js, preload.js, renderer.js, csv.js, index.html 여섯 파일을 확인해요. 파일 위치는 폴더의 절대 경로로 전달하면 좋아요. 절대 경로는 드라이브나 최상위 폴더부터 적은 전체 주소예요.
분석을 시작하기 전에 “이 파일들을 분석해 버튼 하나의 동작을 설명한다”는 범위를 정해요. 이번 단계에서는 의존성을 설치하거나 npm start를 실행하지 않아도 돼요. 파일 구조를 읽는 데 필요한 준비와 앱 전체를 실제 실행하는 준비를 분리하는 거예요.
ZIP은 나중에 바뀔 수 있어요. 이번에 확인한 내용은 릴리스 6.7.0에 고정된 예제 폴더를 기준으로 했어요. 다른 내용이 보이면 예제 버전과 받은 날짜를 기록하고 출력 차이를 먼저 확인해요.
4. ‘내보내기’ 한 가지 동작만 질문해요
다음 요청문은 독자가 응용하도록 새로 만든 예시예요. 개인 프로젝트에서 사용한 비공개 대화나 실제 요청문을 옮긴 내용은 아니에요.
복사 예문 · 저장 흐름 조사
CLI로 정적 분석만 실행하려면 다음처럼 입력해요. 따옴표 안을 압축 푼 폴더의 절대 경로로 바꿔야 해요. Windows에서도 공백이 있는 경로는 따옴표로 감싸요.
npx rea-agents@6.7.0 analyze-javascript-application "/absolute/path/to/notes-example" --json
--json은 기계가 읽기 쉬운 구조로 결과를 달라는 옵션이에요. 이 명령이 앱을 켜서 버튼을 눌렀다는 뜻은 아니에요. 출력 전체를 이해하려 애쓰기보다 normalized_result.summary.ipc의 요약과 normalized_result.graph의 소스 위치를 중심으로 좁혀보세요. 공식 예제 기록은 메시지 채널 하나와 대응하는 처리 함수 하나를 보여줘요.
5. 답변을 실제 코드와 연결해봐요
| 순서 | 파일 | 읽어볼 내용 |
|---|---|---|
| 화면에서 시작 | renderer.js | 버튼 클릭에 연결된 notes.exportCsv 호출 |
| 요청 전달 | preload.js | notes:export라는 이름으로 보내는 메시지 |
| 저장 처리 | main.js | 요청을 받아 경로를 만들고 파일을 쓰는 코드 |
| 내용 만들기 | csv.js | id와 title을 CSV 문자열로 만드는 함수 |
이 사이의 메시지 전달을 IPC라고 불러요. 여기서는 화면 쪽과 앱의 주요 처리 쪽이 이름 붙인 메시지로 대화한다고 이해하면 충분해요. 약자를 외우는 것보다 요청 이름과 처리하는 쪽이 실제로 연결되는지 보는 게 중요해요.
공식 코드에서 main.js는 운영체제가 알려주는 다운로드 폴더에 notes.csv라는 파일 이름을 붙여요. CSV를 만드는 함수에는 메모 목록을 전달하고, 만들어진 문자열을 UTF-8로 써요. 그러므로 “항상 C 드라이브의 특정 주소에 저장된다”고 설명하면 부정확해요. 다운로드 폴더의 실제 주소는 사용자의 환경에 따라 달라져요.
여기까지는 코드에 적힌 흐름을 읽은 결과예요. 그 컴퓨터에서 실제 파일 저장이 성공했다는 확인은 앱을 실행하고 파일을 열어보는 단계에서 따로 해야 해요.
6. 입력을 바꿔 예측과 실제 결과를 비교해요
이번 확인은 작은 CSV 변환 함수만 Node.js로 실행해요. 운영체제마다 명령 창의 따옴표 처리 방식이 다를 수 있으니, 짧은 확인 파일을 만들어 같은 방식으로 실행해볼게요.
새 파일 check-csv.cjs를 csv.js가 있는 예제 폴더에 만들고 다음 코드를 넣어요. 이것은 원본 앱을 바꾸지 않는 별도 확인 파일이에요.
const { toCsv } = require('./csv.js');
process.stdout.write(toCsv([{ id: 1, title: 'Hello, "REA"' }]));
그다음 node check-csv.cjs를 실행해요. CSV 텍스트를 명령 창에 출력하며 notes.csv를 만들지는 않아요. 공식 함수에서 기대하는 출력은 다음과 같고 마지막에는 줄바꿈이 하나 있어요.
id,title
1,"Hello, ""REA"""
CSV는 쉼표로 항목을 나눠요. 제목 자체에 쉼표가 들어 있으므로 제목 전체를 따옴표로 감싸고, 제목 안의 따옴표는 두 번 적어요. 그래야 제목 한 개가 여러 칸으로 갈라지지 않아요. 이 확인이 맞아도 운영체제 다운로드 경로, 파일 쓰기 권한, 앱 화면까지 검증한 것은 아니에요. 실제로 시험한 함수와 조건만 기록해요.
작업이 막히면 이 순서로 봐요
| 보이는 문제 | 먼저 확인할 내용 |
|---|---|
| REA 도구가 보이지 않아요. | setup에 선택한 에이전트와 현재 사용 중인 에이전트가 같은지, 다시 시작했는지 봐요. |
| 파일이 없다고 나와요. | ZIP 바깥 폴더가 아니라 여섯 파일이 들어 있는 폴더의 전체 경로인지 확인해요. |
| Node.js 관련 오류가 나요. | 현재 명령 창의 node -v가 지원 범위에 들어가는지 확인해요. |
| Hopper나 Ghidra가 없다고 나와요. | 이번 작업은 JavaScript 정적 분석이에요. 네이티브 바이너리 분석을 선택한 것은 아닌지 봐요. |
| 답은 길지만 저장 위치가 없어요. | main.js의 경로 계산과 파일 쓰기 부분을 파일·줄 번호와 함께 다시 요청해요. |
| 코드와 AI의 설명이 달라요. | 어느 파일의 어느 버전을 읽었는지 확인하고 근거가 없는 설명은 미확인으로 남겨요. |
에이전트 등록 문제를 좁혀 진단할 때의 공식 명령은 npx rea-agents@6.7.0 doctor --client codex --json이에요. 사용 중인 클라이언트가 Cursor라면 codex를 cursor로 바꿔요. doctor는 설정과 준비 조건을 검사하는 진단 명령이라, 앱 분석이나 연결된 AI 대화까지 성공했다는 증명은 아니에요.
조사 메모는 짧게 남겨도 좋아요
예제 버전과 경로, 확인한 파일, 변경한 입력, 예상 출력, 실제 출력, 아직 확인하지 않은 내용을 적어두세요. 나중에 질문을 더 할 때 같은 자료를 보고 있는지 확인하기 쉬워져요. 실행하지 않은 항목은 빈칸이나 ‘미실행’으로 남기면 돼요.
이 연습을 마치면 “AI가 저장한다고 했다”에서 “어느 코드가 어떤 문자열을 만들며 내가 어느 조건까지 확인했다”로 설명이 구체화돼요. 다음 대상도 앱 전체보다 하나의 기능을 조사할 가치가 있는지부터 골라보세요.
실습의 공식 근거
설치 문서, CLI 문서, 공식 첫 조사 안내, 릴리스에 고정한 CSV 함수, 저장 처리 코드를 확인했어요. 공식 웹 가이드의 분석 기록은 REA 4.1.0에서 작성됐으며, 이 글은 6.7.0의 명령·소스와 함께 읽도록 구성했어요.
참고 자료
- https://github.com/morluto/rea/releases/tag/rea-agents-6.7.0
- https://github.com/morluto/rea/blob/27dc42d10249f0410904a75c0997842eb03b931c/README.md
- https://github.com/morluto/rea/blob/27dc42d10249f0410904a75c0997842eb03b931c/package.json
- https://github.com/morluto/rea/blob/27dc42d10249f0410904a75c0997842eb03b931c/docs/installation.md
- https://github.com/morluto/rea/blob/27dc42d10249f0410904a75c0997842eb03b931c/docs/cli.md
- https://rea.tools/first-investigation/
- https://rea.tools/guides/javascript/
- https://github.com/morluto/rea/blob/27dc42d10249f0410904a75c0997842eb03b931c/website/public/examples/notes-electron/csv.js
- https://github.com/morluto/rea/blob/27dc42d10249f0410904a75c0997842eb03b931c/website/public/examples/notes-electron/main.js
- https://nodejs.org/