> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parallelane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 커밋 그래프

> 레인, 스코프, 미니맵, 그래프 검색

커밋 그래프는 저장소의 커밋과 브랜치 구조를 레인(lane)으로 그립니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/history-graph-lanes.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=959cc2fe263216f0ef69a9002a3ddc70" alt="여러 색 레인과 브랜치 배지, 작성자·날짜 라벨이 있는 커밋 그래프" width="1726" height="1784" data-path="images/history-graph-lanes.png" />
</Frame>

## 레인 읽기

세로줄 하나가 하나의 **레인**이고, 살아 있는 브랜치마다 레인이 하나씩 배정됩니다.

* **맨 왼쪽 레인** — 첫 번째 부모(first-parent)를 따라 내려가는 트렁크입니다.
  위에서 아래로 곧게 이어집니다.
* **오른쪽 레인들** — 갈라져 나온 사이드 브랜치입니다.
  머지되면 트렁크 쪽으로 수렴합니다.
* **연결선** 의 색은 그 선의 세로 구간이 놓인 레인 색을 따릅니다.

<Tip>
  레인 색은 브랜치를 구분하기 위한 것이며 고정된 의미는 없습니다.
</Tip>

## pushed / unpushed 노드 구분

노드의 채움 형태로 원격 여부를 나타냅니다.
**채워진 원** 은 어느 원격에든 존재하는 커밋, **빈 원** 은 로컬에만 있는 커밋입니다.
현재 체크아웃한 커밋(HEAD)이 unpushed이면 그 노드에만 물결 파장 애니메이션이 나타납니다.

<Note>
  pushed 판정은 **마지막 `git fetch` 시점의 원격 상태**를 기준으로 합니다.
</Note>

## 스코프 토글 (전체 / 현재 브랜치)

* **기본 워크트리** — 항상 모든 브랜치를 그립니다.
* **연결된(linked) 워크트리** — 기본이 **현재 브랜치만** 이며, 헤더의 토글 버튼으로 전환합니다.

자세한 조건은 [워크트리별 상태](/ko/worktrees/status)에서 다룹니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/history-graph-scope.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=865c8eb713d4e21baab841a1c6c394b1" alt="연결된 워크트리에서 현재 브랜치만 보도록 스코프를 좁힌 커밋 그래프" width="1726" height="1784" data-path="images/history-graph-scope.png" />
</Frame>

## 그래프 검색과 필터

<Steps>
  <Step title="검색 열기">
    그래프 우상단에 검색 바를 엽니다.
    여는 키는 [단축키](/ko/shortcuts)에 정리돼 있습니다.
  </Step>

  <Step title="검색어 입력">
    자유 텍스트는 커밋 SHA 앞부분과 커밋 요약에서 대소문자 구분 없이 찾습니다.
    `현재 / 전체` 카운트가 표시됩니다.
  </Step>

  <Step title="필터 조합">
    `key:value` 필터를 자유 텍스트와 함께 입력하면 pill로 바뀌며, 여러 개를 조합할 수 있습니다.

    | 필터         | 의미            | 예시                    |
    | ---------- | ------------- | --------------------- |
    | `author:`  | 작성자 이름 또는 이메일 | `author:alice`        |
    | `message:` | 커밋 요약         | `message:"fix login"` |
    | `path:`    | 해당 경로를 바꾼 커밋  | `path:src/auth.ts`    |
    | `after:`   | 지정 날짜 0시부터    | `after:2026-07-01`    |
    | `before:`  | 지정 날짜 0시 이전   | `before:2026-07-22`   |

    공백이 있는 값은 큰따옴표로 묶습니다.
  </Step>

  <Step title="결과 이동">
    검색 바의 이전·다음 버튼으로 결과 사이를 이동하면 그 커밋이 화면에 보이도록 스크롤·선택됩니다.
    결과가 있으면 **일치한 커밋만 또렷하게** 남고 나머지는 흐려집니다.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/history-graph-search.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=4e975f3e2379a38b8ac08f722b4587ea" alt="그래프 우상단에 열린 커밋 검색 바 — 돋보기 아이콘, '커밋 검색…' 입력창, 이전·다음·닫기 버튼" width="1726" height="1784" data-path="images/history-graph-search.png" />
</Frame>

<Note>
  검색 범위는 현재 스코프에 로드된 커밋입니다.
  자유 텍스트와 `message:` 는 요약만 검색하며 본문은 검색하지 않습니다.
</Note>

## 미니맵

그래프 우측 하단에 떠 있는 미니맵으로 긴 히스토리를 빠르게 이동합니다.

* 레인·노드·엣지 토폴로지만 축소해 그리고, 현재 보이는 범위를 **뷰포트 박스**로 표시합니다.
* 아무 곳을 클릭하면 그 지점이 중심이 되도록 이동하고, 드래그하면 이어서 스크럽됩니다.
  휠 스크롤도 동작합니다.
* 우측의 **상대 날짜 칩**("오늘", "3주 전")으로 대략적인 시간 위치를 알 수 있습니다.
* 스크롤이 필요 없을 만큼 히스토리가 짧으면 자동으로 숨겨집니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/history-graph-navigator.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=707e87bed20f117d362f0ff4032c4d74" alt="미니맵 패널 — 축소된 그래프 토폴로지 위에 현재 보이는 범위를 표시하는 뷰포트 박스와 상대 날짜 칩" width="224" height="400" data-path="images/history-graph-navigator.png" />
</Frame>

## 날짜 섹션

커밋은 같은 상대 날짜 라벨끼리 한 섹션으로 묶이고, 섹션 첫 행 우측에 라벨이 표시됩니다.
라벨은 오래될수록 버킷이 커집니다 — **오늘 / 어제 / N일 전**(6일까지) → **N주 전**(29일까지) → **N개월 전**(364일까지) → **N년 전**. 라벨에 마우스를 올리면 정확한 날짜가 툴팁으로 보입니다.

<Note>
  커밋 정렬은 위상정렬이라 시간 순서가 항상 단조롭지 않습니다.
  같은 라벨이 떨어진 위치에 다시 나타나면 섹션 머리글도 다시 표시됩니다.
</Note>

## 커밋 선택과 상세

커밋을 클릭하면 오른쪽에 상세 정보(작성자·시각·메시지·변경 파일)가 열립니다.
여러 개를 선택하면 스쿼시와 여러 커밋 cherry-pick의 대상이 됩니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/history-commit-detail.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=c5d3862a1936a3f6aea6d44efc5d6697" alt="커밋 하나를 선택한 그래프와, 작성자·시각·메시지·변경 파일이 표시된 오른쪽 커밋 상세 패널" width="2386" height="1784" data-path="images/history-commit-detail.png" />
</Frame>

### HEAD 계보 강조

그래프는 **현재 HEAD에서 도달 가능한 커밋**을 또렷하게, 그 밖의 커밋은 흐리게 그립니다.
기준은 항상 HEAD이므로 커밋을 골라도 바뀌지 않습니다.

<Note>
  검색 결과가 하나 이상이면 이 강조가 검색 결과 강조로 대체됩니다.
</Note>

<Tip>
  커밋을 **더블클릭**하면 체크아웃, **우클릭**하면 작업 메뉴가 열립니다.
  [체크아웃](/ko/history/checkout), [브랜치 & 태그 관리](/ko/history/branches-tags), [리베이스 & 머지](/ko/history/rebase-merge)를 참고하세요.
  우클릭 메뉴를 읽는 규칙은 [화면 둘러보기](/ko/interface-overview#컨텍스트-메뉴)에 정리돼 있습니다.
</Tip>