Ropeman을 처음 써 보는 분들이 가장 많이 묻는 질문을 모았습니다. 여기서 답을 찾지 못했다면 문제 해결 문서도 함께 살펴보세요.

보안과 데이터

제 프로젝트의 원본 소스 코드가 외부 서버로 유출되나요?

안심하셔도 됩니다. 어떠한 경우에도 원본 소스 코드는 외부로 전송되지 않습니다. AI가 맥락을 파악하기 위해 필요한 최소한의 코드 구조 정보(메타데이터)만 활용되며, AI 연동 모드에 따라 다음과 같이 처리됩니다.

• WebGPU 모드 (최고 보안) — 100% 기기 내부에서 오프라인으로 처리되며, 어떠한 데이터도 외부로 나가지 않습니다.
• Demo / API Key 모드 — 보안이 적용된 자체 중계 서버(Edge Proxy)를 거쳐 AI 모델 제공사로 안전하게 전달됩니다.
• Bridge 모드 — 로컬에 설치된 CLI 툴을 통해 AI 모델 제공사의 서버로 직접 전송됩니다. Ropeman 인프라를 거치지 않습니다.

입력한 API 키는 안전하게 보관되나요?

API 키는 저희 서버에 절대 저장되지 않으며, 오직 사용자 기기의 브라우저 로컬 저장소(localStorage) 에만 보관됩니다.

• API Key 모드 — 브라우저에 저장된 키는 API 호출 시에만 일회성으로 사용되며, 보안 통신을 통해 AI 모델 제공사로 전달됩니다.
• Bridge 모드 — 별도의 API 키 입력 없이, 로컬에 연동된 CLI 툴의 인증 방식을 그대로 사용합니다.
• WebGPU 모드 — 오프라인으로 동작하므로 API 키 자체가 필요하지 않습니다.

설정 초기화 버튼이나 브라우저 사이트 데이터 삭제로 언제든지 삭제할 수 있습니다.

회사 기밀 프로젝트에 써도 되나요?

가장 엄격한 환경이라면 Bridge 또는 WebGPU 모드를 권장합니다. 이 두 모드는 Ropeman 인프라를 전혀 거치지 않습니다. Demo와 API Key 모드는 자체 프록시를 경유하지만 요청 본문은 저장되지 않습니다. 더 자세한 내용은 보안 문서에서 확인하세요.

상업적으로 이용할 수 있나요?

Ropeman은 개발 도구로서 상업적 프로젝트 분석에 자유롭게 활용할 수 있습니다. 다만 Demo 모드의 경우 공정 사용 한도가 있으므로, 지속적인 업무 활용에는 API Key 또는 Bridge 모드를 권장합니다.

지원 범위

어떤 프로그래밍 언어를 지원하나요?

Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, Ruby, PHP, Swift, Kotlin, C# 을 지원합니다. 파일 확장자로 자동 감지됩니다.

프로젝트 크기에 제한이 있나요?

파일 수 최대 2,000개, 개별 파일 최대 500KB 까지 지원합니다. 대규모 프로젝트는 Settings의 코드 구조 요약 크기를 조절해 AI 전송 한도를 맞추세요(기본 250KB).

어떤 브라우저에서 동작하나요?

• Chrome, Edge 등 Chromium 기반 브라우저 권장 — File System Access API를 완전히 지원합니다.
• Firefox / Safari — 드래그 앤 드롭 폴더 업로드로 제한적 사용이 가능합니다.
• WebGPU 모드 는 WebGPU를 지원하는 최신 브라우저에서만 동작합니다.

완전 오프라인으로 쓸 수 있나요?

WebGPU 모드는 첫 모델 다운로드 이후 오프라인에서 동작합니다. Bridge 모드는 로컬 CLI 자체는 로컬이지만, CLI가 내부적으로 AI 제공사 API를 호출하기 때문에 네트워크는 필요합니다. Demo와 API Key 모드는 인터넷 연결이 필요합니다.

사용 방법

분석 결과가 저장되나요?

예. 분석 결과는 브라우저에 자동으로 캐시되어, 같은 프로젝트를 다시 열면 AI 재호출 없이 즉시 복원됩니다. Settings의 “분석 캐시” 토글로 이 동작을 제어할 수 있으며, “캐시 지우기” 버튼으로 수동 삭제할 수 있습니다.

드릴다운이란 무엇인가요?

다이어그램의 한 영역(예: “API 레이어”)을 더블클릭하면 AI가 해당 영역 내부의 구조를 다시 분석해 새로운 하위 다이어그램을 생성합니다. 원하는 깊이까지 반복적으로 파고들 수 있습니다.

파싱 에러가 나면 어떻게 해야 하나요?

특정 파일에서 파서가 실패하면 해당 파일만 건너뛰고 나머지 파싱은 계속 진행됩니다. 브라우저 개발자 도구 콘솔에서 어떤 파일이 실패했는지 확인할 수 있습니다. 자세한 대응은 문제 해결 문서를 참고하세요.

GitHub URL로 분석할 수 있나요?

네. 랜딩 페이지에서 공개 GitHub 저장소의 URL을 입력하면 로컬에 프로젝트를 다운로드하지 않고도 바로 분석할 수 있습니다. 비공개 저장소는 지원되지 않습니다.

분석 결과를 공유할 수 있나요?

네. AI 분석이 완료된 후 헤더의 Share 버튼을 클릭하면 공개 링크가 생성됩니다. 이 링크를 통해 다른 사람과 분석 결과를 공유할 수 있습니다.

Ropeman은 어떻게 설치하나요?

설치는 필요 없습니다. https://ropeman.dev에 접속하면 바로 사용할 수 있습니다.