Rauhwpx

.hwp와 .hwpx 문서를 열고, 직접 고치거나 옆의 사이드바에서 AI에게 맡깁니다. AI가 바꾼 내용은 문서 위에 바로 표시되고, 확인한 것만 남깁니다. AI를 연결하지 않아도 편집기로 쓸 수 있습니다.

이렇게 씁니다

수정의 흐름도 남깁니다. 버전 기록을 켜면 실행 취소와 별개로 이전 상태를 다시 열어 볼 수 있고, 다른 방향의 수정안을 분기로 나눠 작업할 수 있습니다. 문서와 이력 전체는 .rhwpx 파일 하나로 보관합니다.

여러 일을 함께 맡깁니다. 문서마다 채팅을 따로 열 수 있고, 다른 문서로 옮겨 가도 진행 중인 AI는 멈추지 않습니다. 채팅 목록에서 어느 문서의 어떤 작업이 진행 중인지 바로 확인합니다.

설치

최신 릴리스에서 운영체제에 맞는 파일을 받습니다.

운영체제	파일
macOS · Apple Silicon	.dmg	서명·공증
Windows · x64	.exe	미서명, SmartScreen 경고가 뜰 수 있음
Linux · x64, arm64	.AppImage .deb

AI 연결

설정 → AI에서 쓸 AI를 고르면 설치와 로그인까지 앱이 안내합니다.

연결	방식
Claude · Codex	각 도구의 계정과 인증을 그대로 연결합니다
Pi	OpenRouter 키와 모델 설정을 사용합니다

[!NOTE] 문서 엔진은 내 컴퓨터에서 동작하지만, AI 요청에는 문서 내용과 참고 자료가 포함되어 연결한 서비스로 전송됩니다.

네 가지 모드

AI가 문서를 얼마나 고칠 수 있는지는 모드로 정합니다. 입력창의 모드 버튼에서 고르거나 Shift+Tab으로 차례로 바꿉니다. 메시지 앞에 /chat /plan /agent /full을 붙이면 그 모드로 보냅니다.

모드	문서에 하는 일	이럴 때
채팅	읽기만 합니다	질문, 요약, 자료 조사
플랜	계획을 먼저 보여 주고, 승인하면 실행합니다	여러 곳을 고치는 큰 작업
에이전트	편집을 문서 위에 보여 주고 검토를 기다립니다	대부분의 편집
전체	검토 없이 바로 반영합니다	믿고 맡기는 반복 작업

• 플랜의 계획은 에이전트로 실행하거나 전체 접근으로 실행합니다. 고칠 점이 있으면 수정 요청을 누릅니다.
• 전체 모드에서는 AI가 쓸 때마다 실행 취소 한 단계가 쌓여 차례로 되돌릴 수 있습니다.
• 같은 문서에서 다른 채팅이 편집하는 동안에는 채팅 모드만 쓸 수 있습니다.
• 새 대화의 기본 모드는 설정 → AI에서 바꿉니다. 처음에는 에이전트 모드로 작은 문단부터 맡겨 보는 편이 좋습니다.

선택한 문단을 보고서 문체로 다듬어 주세요. 숫자와 고유명사는 그대로 두세요.

/plan 참고 자료를 읽고 이 표의 빈 설명 칸을 채워 주세요. 근거가 없는 칸은 비워 두세요.

/chat 핵심 내용과 더 확인할 부분만 정리해 주세요.

지원 형식

형식	열기	편집·저장
HWPX	●	●
HWP 5.0	●	●
HML	●	●
HWP 3.0	●

새 문서는 HWPX로 저장합니다. 암호나 DRM이 걸린 문서는 열 수 없고, 문서에 따라 글꼴이나 쪽 나눔이 한컴 오피스와 다르게 보일 수 있습니다. 중요한 파일은 사본으로 먼저 작업하는 편이 안전합니다. 앱에서는 PDF로 저장할 수 있고, CLI로는 PNG·SVG·텍스트·마크다운도 내보냅니다.

개발

Node.js 22.18 이상, rustup으로 설치한 Rust, wasm-pack 0.15.0이 필요합니다. Rust 버전과 WASM 타깃은 rhwp/rust-toolchain.toml이 고정합니다.

git clone https://github.com/heemangstudio/Rauhwpx.git hamaeditor
cd hamaeditor

cargo install wasm-pack --version 0.15.0 --locked
npm run setup
npm run build:wasm
npm run dev:studio

편집기는 http://127.0.0.1:7700 에서 열리고 에이전트 허브도 함께 뜹니다. 다른 터미널에서 npm run dev:desktop을 실행하면 같은 개발 서버에 Electron 창이 붙습니다.

데스크톱 앱 전체를 빌드해 실행할 때는 다음 명령을 씁니다.

npm run build:desktop
npm run desktop

검사는 바꾼 영역에 맞춰 고릅니다. 자세한 절차는 기여 안내에 있습니다.

npm run test:ci
npm --prefix rhwp/rhwp-studio test
npm --prefix rhwp/rhwp-agent test

경로	내용
rhwp/src/	Rust 문서 엔진. 파싱, 문서 모델, 조판·렌더링, 저장
rhwp/rhwp-studio/	TypeScript 편집기와 AI 사이드바
rhwp/rhwp-agent/	로컬 허브. AI 연결, 인증, MCP 도구
desktop/	Electron 셸
site-api/	웹사이트 체험 신청과 데스크톱 설치 집계
rhwp/rhwp-{chrome,firefox,safari,vscode}/	뷰어 확장

AI가 문서를 고칠 때는 허브가 MCP 도구 호출을 편집기로 넘기고, 편집기가 열린 문서에 적용합니다. 모든 읽기는 revision을 돌려주고 모든 쓰기는 그 값을 요구하므로, 그사이 문서가 바뀌었다면 쓰기가 거절됩니다. 도구 목록은 rhwp/rhwp-agent/tools.mjs에 있습니다.

함께 다듬기

잘 열리지 않는 문서나 저장 후 달라지는 부분은 이슈로 알려 주세요. 운영체제, 앱 버전, 기대한 결과와 실제 결과를 적어 주시면 확인이 빠릅니다. 재현용 파일은 개인정보를 지우고 올려 주세요.

라이선스

Edward Kim의 rhwp에서 출발한 프로젝트입니다. MIT 라이선스를 따르며, 함께 쓰는 구성 요소는 서드파티 라이선스에 정리되어 있습니다.

한글, 한컴, HWP, HWPX는 한글과컴퓨터의 상표입니다. 이 프로젝트는 한글과컴퓨터와 관계가 없습니다.