Ropeman은 임의의 코드베이스를 브라우저에서 분석하여 AI 기반 의미론적 아키텍처 다이어그램으로 시각화하는 웹 애플리케이션입니다. 파일 트리가 아닌, 프로젝트의 역할과 의존 관계를 한눈에 보여줍니다.

Ropeman이란

낯선 저장소를 열었을 때 가장 먼저 필요한 것은 “이 프로젝트가 전체적으로 무엇을 하는가” 에 대한 지도입니다. Ropeman은 다음과 같은 방식으로 이 질문에 답합니다.

• Semantic-First — 메인 캔버스는 파일 트리가 아닌 역할 기반 다이어그램입니다. LLM이 코드 구조를 분석해 “인증 계층”, “API 레이어”, “렌더링 엔진” 같은 의미 단위로 묶어 보여줍니다.
• 재귀적 드릴다운 — 다이어그램의 어떤 영역이든 더블클릭하면 AI가 하위 구조를 다시 분석해 새로운 다이어그램을 생성합니다. 원하는 깊이까지 파고들 수 있습니다.
• 100% Local-First — 원본 소스 코드는 절대 브라우저를 떠나지 않습니다. 브라우저 안에서 WASM 기반 AST 파싱이 이루어지고, AI에는 코드 구조 요약(메타데이터) 만 전달됩니다.
• Zero Friction — 회원가입, 설치, CLI 없이 URL에 접속해 폴더를 드롭하기만 하면 됩니다.

30초 퀵스타트 (Demo 모드)

가장 빠른 경로는 설정이 전혀 필요 없는 Demo 모드입니다.

1. 접속 — https://ropeman.dev를 Chrome 또는 Edge 등 Chromium 기반 브라우저에서 엽니다. Firefox와 Safari에서는 드래그 앤 드롭으로 제한적 사용이 가능합니다.
2. 폴더 열기 — 분석하고 싶은 프로젝트 디렉토리를 랜딩 페이지에 드래그하거나 “폴더 열기” 버튼으로 선택합니다. 파일 시스템 접근은 로컬에서만 이루어집니다.
3. 파싱 대기 — 브라우저 내부 파서가 각 파일의 구조를 추출합니다. 파일 수에 따라 수 초 안에 완료됩니다.
4. AI 분석 실행 — 기본 Demo 트랙이 선택된 상태로 “분석” 버튼을 누르면 LLM이 아키텍처 다이어그램을 생성합니다.
5. 탐색 — 원하는 노드를 더블클릭해 하위 구조를 드릴다운하거나, 파일을 더블클릭해 코드 뷰어로 확인합니다.

GitHub URL로 바로 분석하기

로컬에 프로젝트가 없어도, 공개 GitHub 저장소의 URL을 입력하면 바로 분석할 수 있습니다.

1. 랜딩 페이지의 URL 입력란에 GitHub 저장소 주소를 붙여넣습니다 (예: https://github.com/owner/repo).
2. “분석” 버튼을 클릭하면 저장소의 파일 구조를 자동으로 가져와 파싱합니다.
3. 이후 과정은 로컬 폴더를 열었을 때와 동일합니다 — AI 분석, 드릴다운, 코드 보기 모두 사용 가능합니다.

비공개 저장소는 지원되지 않으며, 공개 저장소만 분석할 수 있습니다.

지원 언어

총 14개 프로그래밍 언어를 지원합니다 — Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, Ruby, PHP, Swift, Kotlin, C#, Scala. 단일 프로젝트 내에서 여러 언어가 섞여 있어도 한 번에 분석할 수 있습니다.

파일별 언어는 확장자 기반으로 자동 감지되며, 지원되지 않는 파일은 건너뜁니다.

다음 단계

• 더 강력한 AI 모델을 쓰고 싶다면 AI 모드 가이드에서 API Key · Bridge · WebGPU 모드를 살펴보세요.
• 보안이 걱정된다면 보안 및 데이터 흐름 문서를 먼저 읽어보시기 바랍니다.
• 단축키를 익히면 탐색이 훨씬 빨라집니다. 키보드 단축키 참고.
• 문제가 생겼다면 자주 묻는 질문 또는 문제 해결을 확인하세요.