> ## 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.
# 화면 둘러보기
> 주요 화면 구성과 각 영역의 역할, 공통 컨텍스트 메뉴 규칙
ParalleLane의 화면은 크게 세 개의 세로 영역으로 나뉩니다. 왼쪽에서 저장소와 워크트리를 고르고, 가운데에서 커밋 그래프와 diff를 보고, 오른쪽에서 선택한 커밋의 상세와 **워킹 카피(Working copy)** 를 다룹니다. 좌우 사이드바 폭은 경계를 끌어 조절할 수 있습니다.
## 타이틀바
창 맨 위의 커스텀 타이틀바입니다. 세 영역의 헤더가 이 한 줄에 나란히 놓여 하나의 바처럼 보입니다. 빈 공간을 잡고 창을 옮길 수 있고, 더블클릭하면 창이 최대화됩니다. macOS에서는 왼쪽에 시스템 창 버튼 자리가 비워지고, Windows·Linux에서는 최소화·최대화·닫기 버튼이 오른쪽 끝에 표시됩니다.
## 좌측 사이드바
저장소와 그 구조를 탐색하는 영역입니다. 상단의 두 탭으로 보기를 전환합니다.
등록한 저장소들이 목록으로 나타나고, 저장소를 펼치면 그 안의 **워크트리**가 함께 보입니다. 그룹으로 저장소를 묶어 정리할 수도 있습니다. 워크트리를 선택하면 가운데 그래프가 해당 워크트리 기준으로 다시 그려집니다.
워크트리 행의 오른쪽 끝에는 원격과 어긋난 만큼의 앞섬·뒤짐 개수가 표시되고, 연결된(linked) 워크트리 행에 마우스를 올리면 같은 자리에 삭제 버튼이 나타납니다(기본 워크트리는 삭제 대상이 아니라 버튼이 없습니다). Git LFS로 추적되는 저장소와 서브모듈은 이름 옆에 테두리만 있는 **LFS** 배지가 붙습니다.
현재 선택한 저장소의 로컬 브랜치, 원격 브랜치, 태그, 스태시, 서브모듈을 섹션별로 한데 모아 보여줍니다. LFS로 관리되는 파일이 있으면 맨 아래에 **Git LFS** 섹션이 더해집니다. 여기서 항목을 눌러 체크아웃하거나 우클릭 메뉴로 작업을 실행합니다. 체크아웃된 로컬 브랜치에는 왼쪽에 체크 표시가 붙습니다.
브랜치와 태그는 글롭 패턴으로 묶는 커스텀 그룹(스마트 그룹)으로 정리할 수도 있습니다. 섹션 헤더에 마우스를 올리면 개수 자리에 **새 그룹(New group)** 버튼이 나타나고, 그룹이 하나라도 있으면 그 앞에 **그룹 관리(Manage groups)** 버튼이 함께 놓입니다. 자세한 사용법은 [브랜치와 태그](/history/branches-tags)에서 다룹니다.
사이드바 맨 아래에는 계정 버튼과 설정 버튼이 있습니다.
각 저장소 아래에는 기본 워크트리와 연결된(linked) 워크트리가 나란히 표시됩니다. 워크트리가 무엇이고 어떻게 활용하는지는 [워크트리 이해하기](/worktrees/concept)에서 자세히 다룹니다.
## 상단 바
가운데 영역의 맨 윗줄입니다. 왼쪽에는 지금 보고 있는 위치가 **저장소 ⟩ 워크트리 ⟩ 브랜치** 경로로 표시됩니다(기본 워크트리를 볼 때는 워크트리 칸이 생략되고, 분리된 HEAD(detached HEAD)면 브랜치 자리에 짧은 SHA가 들어갑니다). 오른쪽에는 현재 탭에 맞는 액션 버튼이 놓입니다. 커밋 그래프를 보는 **히스토리(History)** 탭에서는 되돌리기·다시 실행, **비교(Compare)**, **.gitignore 편집** 버튼이 보이고, 조건이 맞을 때 두 버튼이 더해집니다 — **모든 브랜치 보기 / 현재 브랜치만 보기** 전환은 연결된(linked) 워크트리에서만, **원격 트래킹 브랜치 정리(Prune)** 는 원격이 있는 저장소에서만 나타납니다. 이 버튼이 여는 모달의 제목은 **Prune** 입니다.
### 다음에서 열기(Open in…)
상단 바 오른쪽 끝에는 지금 선택한 워크트리 폴더를 다른 도구로 여는 버튼이 있습니다. 옆의 화살표를 누르면 메뉴가 열립니다.
Finder, 터미널처럼 앱에 내장된 대상입니다. 지울 수는 없고, 설정에서 끄면 메뉴에서 숨겨집니다.
설정에서 직접 등록한 앱이 메뉴 아래쪽에 함께 나열됩니다.
저장소의 웹 주소를 알 수 있을 때, 브라우저에서 원격 저장소 페이지를 엽니다.
워크트리 폴더의 경로를 클립보드에 복사합니다. 복사되면 메뉴에 체크가 잠깐 표시됩니다.
메뉴에서 한 번 고른 항목은 기억되어, 다음부터는 화살표 왼쪽의 버튼을 한 번 누르는 것만으로 같은 동작을 다시 실행할 수 있습니다.
메뉴에 넣을 앱과 숨길 항목은 **설정 → ParalleLane → Open In** 에서 전체 기본값으로 지정하고, **설정 → 프로젝트(Projects) → Open In** 에서 저장소마다 따로 재정의할 수도 있습니다(재정의는 Pro 기능이라 Basic에서는 **PRO** 배지가 붙습니다). 항목 등록과 아이콘 변경, 요금제 조건은 [Open In 설정](/settings/open-in)에서 자세히 다룹니다.
푸시·풀·페치·스태시 아이콘 버튼은 상단 바가 아니라 같은 줄에 이어지는 우측 사이드바 헤더에 있습니다. 각 동작의 자세한 설명은 [푸시·풀·페치](/remote/push-pull-fetch)에서 확인하세요.
## 가운데: 그래프와 탭
상단 바 아래는 탭 바와 콘텐츠 영역으로 이루어집니다.
* **탭 바** — 첫 번째 **히스토리(History)** 탭이 커밋 그래프이며, 항상 고정되어 닫거나 옮길 수 없습니다. 파일 diff, 비교(compare), 파일 히스토리 등을 열면 그 오른쪽에 새 탭으로 추가되고, 이 탭들은 끌어서 순서를 바꿀 수 있습니다.
* **커밋 그래프** — 브랜치마다 레인을 나눠 커밋을 시간순으로 그립니다. 계산된 레이아웃이 조각 단위로 흘러 들어오므로, 큰 저장소도 첫 조각부터 바로 스크롤하고 클릭할 수 있습니다. 커밋을 클릭하면 우측 사이드바에 상세가 나타납니다.
커밋 점의 모양은 그 커밋이 원격에 있는지를 알려줍니다. 색이 채워진 점은 원격에서 도달할 수 있는 커밋이고, 속이 빈 고리는 아직 푸시하지 않은 커밋입니다.
## 우측 사이드바
선택한 대상에 따라 내용이 바뀌는 영역입니다.
* 맨 위에는 작업 트리의 상태를 요약한 **워킹 카피 카드**가 항상 자리합니다. 변경 개수나 충돌 여부를 여기서 바로 확인하고, 눌러서 워킹 카피 패널을 엽니다.
* 그래프에서 커밋을 선택하면, 위쪽에 커밋 메타 정보(요약·본문·작성자·부모 등)가, 아래쪽에 변경된 파일 목록이 표시됩니다. 파일을 클릭하면 가운데에 diff 탭이 열립니다.
* 워킹 카피를 열면 스테이징·커밋 인터페이스가, 비교 탭에서는 비교 대상 정보가 이 영역에 나타납니다.
위·아래 분할 높이는 가운데 경계를 끌어 조절할 수 있습니다.
## 컨텍스트 메뉴
저장소, 워크트리, 브랜치, 태그, 스태시, 커밋 등 대부분의 항목에는 우클릭 메뉴가 있습니다. 메뉴는 앱 전체에서 같은 규칙을 따르므로, 한 번 익히면 어디서든 같은 방식으로 읽을 수 있습니다. 이 문서에서 개별 메뉴를 설명할 때도 아래 규칙을 전제로 합니다.
* **구분선으로 묶인 그룹** — 항목은 성격별로 묶이고, 그룹은 위에서 아래로 안전한 것부터 위험한 것 순으로 놓입니다. 선택한 대상에 대한 동작 → 만들기·이동·조회 → 통합(머지·리베이스) → 히스토리 편집 → 되돌릴 수 없는 동작 순서입니다. 조건이 맞지 않아 항목이 하나도 없는 그룹은 구분선까지 함께 사라지므로, 메뉴 위아래나 중간에 빈 구분선이 남는 일은 없습니다.
* **빨간색은 되돌릴 수 없는 동작만** — 커밋하지 않은 작업, 참조, 앱에 등록된 항목을 잃을 수 있는 삭제·제거·리셋만 빨간색으로 표시됩니다. 이 동작들은 그 메뉴의 마지막 그룹에 모여, 메뉴가 열린 지점에서 가장 먼 자리에 놓입니다(커밋 그래프에서는 그 뒤에 브랜치·태그 하위 메뉴가 한 그룹 더 따라붙습니다). revert처럼 되돌리는 커밋을 새로 쌓는 동작이나 amend·squash·rebase처럼 로컬 히스토리를 다시 쓰는 동작은 되돌릴 수 있거나 일상적이므로 강조하지 않습니다. 빨간 항목이 흔해지면 강조가 강조로 읽히지 않기 때문입니다.
* **비활성된 위험 항목은 회색** — 조건이 맞지 않아 누를 수 없는 항목은 빨간색 대신 흐린 회색으로 보입니다. 빨간색은 지금 실행할 수 있는 위험한 동작에만 남습니다.
* **이름 끝의 `…`** — 누르면 곧바로 실행되지 않고, **이름을 입력하거나 방식을 고르는** 다이얼로그가 먼저 열린다는 뜻입니다(예: **브랜치 만들기…**, **현재 브랜치에 머지…**). 다음 세 경우에는 다이얼로그가 열리더라도 `…` 이 붙지 않습니다 — 위험한 동작을 한 번 더 확인하기만 하는 안전 확인 다이얼로그(부수적인 토글이 하나 있더라도), 화살표로 이미 표시되는 하위 메뉴, 그리고 상황에 따라서만 다이얼로그가 열리는 항목(작업 트리에 커밋하지 않은 변경이 있을 때만 묻는 **커밋 체크아웃** 등)입니다. 즉시 실행되는 항목에는 붙지 않습니다.
색은 보조 신호일 뿐입니다. 위험한 동작이 실제로 무엇을 잃게 하는지는 열린 다이얼로그의 설명에서 확인하세요 — 앱은 위험을 색이 아니라 문장으로 알리는 것을 원칙으로 합니다.
## 설정 열기
좌측 사이드바 아래의 설정 버튼으로 전체 화면 설정을 엽니다. macOS에서는 화면 상단 메뉴 바의 **ParalleLane → 설정…(Settings…)** 으로도 같은 화면을 열 수 있으며, 앱 언어를 바꾸면 이 메뉴의 라벨도 함께 바뀝니다.
설정 화면 맨 위에는 **ParalleLane** 탭과 **프로젝트(Projects)** 탭이 있습니다. ParalleLane 탭은 앱 전체에 적용되는 설정(일반, 디자인, 단축키, 계정, Git, 서명, Open In, 요금제)이고, 프로젝트 탭은 드롭다운으로 고른 저장소 하나에만 적용되는 설정(계정, Git, 서명, Open In)입니다.
두 탭 모두 **Git** 메뉴를 갖지만 담는 항목이 다릅니다. ParalleLane 탭의 Git은 기본 계정과 fetch·push 기본값, 머지 툴, 비교 뷰의 Blame, LFS 같은 앱 전역 설정이고, 프로젝트 탭의 Git은 그 저장소의 기본 리모트와 리모트 목록입니다. 그래서 이 문서는 설정 경로를 항상 **설정 → ParalleLane → …** 또는 **설정 → 프로젝트(Projects) → …** 처럼 탭까지 붙여 적습니다.
설정 메뉴와 항목은 [설정](/settings/preferences)에서 자세히 설명합니다.