문서
arrow_back 앱으로 돌아가기
EN

시작하기

Ropeman이 무엇인지, 30초 만에 첫 아키텍처 다이어그램을 만드는 방법을 안내합니다.

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 분석, 드릴다운, 코드 보기 모두 사용 가능합니다.

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

대규모 프로젝트 팁

프로젝트가 크거나 모노레포에서 일부 디렉토리를 분석 대상에서 빼고 싶다면 Settings → 추가 제외 디렉토리 textarea에 디렉토리 이름을 1줄 1개씩 입력하세요 (예: target, third_party, generated). 기본 제외 목록(node_modules, .git 등)에 사용자 지정 패턴이 병합됩니다. 변경은 textarea에서 포커스를 빼는 순간(blur) 저장되고 다음 프로젝트 로드부터 적용됩니다.

사이드바 영역이 좁다고 느껴지면 파일 탐색기 오른쪽 경계를 드래그해 너비를 조절할 수 있습니다. 설정은 브라우저에 저장됩니다.

분석 진행 상태와 취소

분석은 페이지를 이동해도 계속 진행됩니다. 화면 우측 하단의 진행 상태 pill은 어느 라우트에서든 표시되며, 빨간색 취소 버튼으로 중단할 수 있습니다. 실수 방지를 위해 확인 다이얼로그가 한 번 뜨며, “다시 묻지 않기”로 이후 생략할 수 있습니다.

드릴다운을 여러 영역에 동시에 실행하면 요청이 각각 별도의 pill로 표시됩니다. 3개를 넘어서면 “N개 분석 중” 그룹 배지로 자동 병합되고, 배지의 펼치기(^) 아이콘으로 개별 요청을 확인·취소할 수 있습니다. 탭이 비활성 상태일 때 분석이 끝나면 브라우저 알림으로 결과를 통지합니다(권한 허용 시).

지원 언어

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

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

다음 단계