레인과 브랜치 구조 읽기
그래프의 각 세로줄이 하나의 레인입니다. 살아 있는 브랜치마다 레인이 하나씩 배정되며, 레인마다 색이 다릅니다.- 맨 왼쪽 레인(lane 0): 맨 위 커밋에서 첫 번째 부모(first-parent) 를 따라 내려가는 줄, 즉 트렁크(주 계보)입니다. 위에서 아래로 곧게 이어지도록 배치되어, 주 흐름이 옆으로 새지 않습니다.
- 오른쪽 레인들: 갈라져 나온 사이드 브랜치입니다. 갈래가 다시 합쳐지면(머지) 레인이 트렁크 쪽으로 수렴합니다.
- 엣지(연결선) 의 색은 그 선의 세로 구간이 놓인 레인의 색을 따릅니다. 그래서 같은 레인을 지나는 선은 모두 같은 색으로 보입니다.
pushed / unpushed 노드 구분
노드의 채움 형태로 그 커밋이 원격에 올라가 있는지를 나타냅니다. 색이 아니라 형태로 구분하므로 레인 색과 무관하게 읽을 수 있습니다.채워진 원
pushed — 어느 원격에든 존재하는(공유·백업된) 커밋입니다. 히스토리 대부분이 여기 해당합니다.
빈 원
unpushed — 로컬에만 있고 아직 어떤 원격에도 올라가지 않은 커밋입니다.
pushed 판정은 마지막
git fetch 시점의 원격 상태를 기준으로 합니다. fetch하지 않은 사이 다른 사람이 같은 커밋을 올렸다면 실제로는 원격에 있어도 unpushed로 보일 수 있습니다.스코프 토글 (전체 / 현재 브랜치)
그래프가 담는 범위는 워크트리 종류에 따라 다릅니다 — 기본 워크트리는 항상 모든 브랜치를 그리고, 연결된(linked) 워크트리는 기본이 현재 브랜치만이며 헤더의 토글 버튼으로 전체 보기와 전환합니다. 토글이 나타나는 조건과 상태가 저장되는 범위는 워크트리별 상태에서 자세히 다룹니다.
그래프 검색과 고급 필터
브라우저의 찾기(Cmd/Ctrl+F)와 비슷하게, 그래프 맥락을 유지한 채 커밋을 찾아 이동합니다.
1
검색 열기
Cmd/Ctrl+F를 누릅니다. 그래프 우상단에 검색 바가 뜨고 입력창에 포커스가 갑니다. 같은 키를 다시 누르면 닫힙니다. (기본 단축키이며 설정 → ParalleLane → 단축키 에서 바꿀 수 있습니다 — 키보드 단축키 참고.)2
검색어 입력
자유 텍스트는 커밋 SHA의 앞부분 또는 커밋 요약(summary)에서 대소문자 구분 없이 찾습니다. 검색 바에는
현재 / 전체(예: 3 / 12) 카운트가 표시되고, 0건이면 결과 없음으로 표시됩니다.3
필터 조합 (선택)
key:value 형식의 필터를 자유 텍스트와 함께 입력합니다. 완성된 필터는 pill로 바뀌며 여러 개를 조합할 수 있습니다.공백이 있는 값은 큰따옴표로 묶습니다. 키를 입력하면 자동완성 목록이 나오고, 날짜 필터에는 날짜 선택기를 사용할 수 있습니다.
4
결과 이동
Enter로 다음 결과, Shift+Enter로 이전 결과로 이동합니다(끝에서 순환). 검색 바의 이전/다음 버튼도 같은 동작입니다. 현재 결과 커밋이 화면에 보이도록 스크롤되며 선택됩니다. 검색 결과가 하나 이상 있으면 일치한 커밋만 또렷하게 남고 나머지는 흐려져, 결과 분포를 그래프에서 바로 볼 수 있습니다.5
검색 닫기
Esc 또는 닫기 버튼으로 닫습니다. 마지막으로 이동한 커밋의 선택 상태는 유지됩니다.
검색 범위는 현재 로드된 활성 스코프의 커밋입니다. “현재 브랜치만” 스코프에서는 그 범위 밖 커밋을 찾지 않습니다. 자유 텍스트와
message:는 제목(summary)을 검색하며 긴 본문(description)은 검색하지 않습니다. path: 결과는 경로 이력을 불러오는 동안 잠시 검색 중… 으로 표시될 수 있습니다.미니맵 (그래프 네비게이터)
긴 히스토리를 빠르게 이동할 수 있도록, 그래프 우측 하단에 떠 있는 미니맵이 있습니다. VS Code 에디터 미니맵과 같은 방식으로 동작합니다.- 그래프의 토폴로지(레인·노드·엣지) 만 축소해 그립니다. 커밋 텍스트는 없고, 갈래의 끝점·분기점만 노드로 찍혀 모양이 단순해집니다.
- 미니맵은 항상 메인 뷰를 따라가며, 현재 보이는 범위를 뷰포트 박스로 표시합니다.
- 패널 아무 곳을 클릭하면 그 지점이 뷰포트 박스의 중심이 되도록 메인 뷰가 이동합니다. 그대로 드래그하면 이어서 스크럽되고, 미니맵 위에서 휠 스크롤해도 메인 뷰가 움직입니다.
- 패널 우측에 상대 날짜 칩(“오늘”, “3주 전” 등)이 함께 표시되어 대략적인 시간 위치를 알 수 있습니다. 칩에 마우스를 올리면 정확한 날짜가 툴팁으로 나옵니다.
- 배경은 평소 살짝 투명하고 마우스를 올리면 불투명해집니다. 히스토리가 짧아 스크롤이 필요 없으면 자동으로 숨겨집니다.
날짜 섹션
커밋을 같은 상대 날짜 라벨끼리 하나의 섹션으로 묶어 보여줍니다.- 각 섹션의 첫 행 우측에 상대 날짜 라벨이 표시됩니다. 라벨은 로컬 시간대의 달력일 차이로 계산하며, 오래될수록 버킷이 커집니다 — 오늘 / 어제 / N일 전(6일까지) → N주 전(29일까지) → N개월 전(364일까지) → N년 전.
- 그래서 하루 단위로 갈라지는 것은 최근 1주일까지이고, 그보다 오래된 구간은 여러 날의 커밋이 “3주 전” 같은 한 섹션에 함께 묶입니다.
- 섹션 경계마다 가로 구분선이 그래프 레인·노드 아래로 깔립니다.
- 날짜 라벨에 마우스를 올리면 그 섹션 첫 커밋의 정확한 날짜(
2026-05-15 (수))가 툴팁으로 보입니다.
커밋 정렬은 위상정렬이라 시간 순서가 항상 단조롭지는 않습니다. 같은 라벨이 떨어진 위치에 다시 나타나면 섹션 머리글도 다시 표시됩니다(GitHub과 동일한 동작).
커밋 선택과 상세
커밋을 한 번 클릭하면 선택되어, 해당 행이 강조되고 상세 정보(작성자·시각·메시지·변경 파일·diff)가 열립니다.Shift 클릭으로 표시 순서상 연속 범위를, Cmd/Ctrl 클릭으로 개별 커밋을 더해 여러 개를 함께 선택할 수 있습니다. 다중 선택은 스쿼시와 여러 커밋 cherry-pick의 대상이 됩니다.
HEAD 계보 강조 (dim)
선택과 별개로, 그래프는 현재 HEAD에서 도달 가능한 커밋(= HEAD의 조상 계보) 을 또렷하게 그리고 그 밖의 커밋은 흐리게(dim) 그립니다. 어디까지가 지금 체크아웃한 계보인지 한눈에 갈라 보이게 하는 표시이며, 커밋을 골라도 바뀌지 않습니다 — 기준은 항상 HEAD입니다.검색이 열려 있고 결과가 하나 이상이면 이 강조가 검색 결과 강조로 대체됩니다(일치한 커밋만 또렷). 결과가 0건이거나 검색을 닫으면 HEAD 계보 강조로 돌아옵니다.