> ## 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.

# 단축키 & 탐색

> 키보드·마우스 탐색과 Git 작업

ParalleLane은 키보드와 마우스로 화면을 탐색하고 워킹 카피(Working copy) 작업을 처리할 수 있습니다. macOS에서는 `Cmd`, Windows·Linux에서는 `Ctrl`을 사용합니다.

## 전역 단축키

아래 두 표의 값은 **기본값**입니다. \*\*설정 → ParalleLane → 단축키(Shortcuts)\*\*에서 명령별로 다시 지정할 수 있습니다(아래 "단축키 재설정" 참고).

| 단축키                        | 동작                                      |
| -------------------------- | --------------------------------------- |
| `Cmd/Ctrl` + `W`           | 활성 탭을 닫습니다. 맨 왼쪽 그래프 탭이 활성일 때는 창을 닫습니다. |
| `Cmd/Ctrl` + `Shift` + `C` | 선택한 워크트리의 워킹 카피를 엽니다.                   |
| `Cmd/Ctrl` + `Z`           | 실행 취소(Undo)                             |
| `Cmd/Ctrl` + `Shift` + `Z` | 다시 실행(Redo)                             |
| `Cmd/Ctrl` + `F`           | 현재 그래프 또는 diff의 검색을 엽니다.                |

모달, 설정 또는 온보딩이 앞에 있으면 뒤 화면의 전역 명령은 실행되지 않습니다. 텍스트 입력란에서는 Undo/Redo가 앱 작업 대신 일반 텍스트 편집에 사용됩니다.

## 워킹 카피

워킹 카피 파일 목록에 포커스가 있고 적용 가능한 파일이 선택됐을 때 동작합니다.

| 단축키                  | 동작                                   |
| -------------------- | ------------------------------------ |
| `Cmd/Ctrl` + `S`     | **스테이지 안됨**에서 선택한 파일을 스테이지(Stage)    |
| `Cmd/Ctrl` + `U`     | **스테이지됨**에서 선택한 파일을 스테이지 해제(Unstage) |
| `Space`              | 선택 파일의 스테이지 / 스테이지 해제 상태 전환          |
| `Cmd/Ctrl` + `Enter` | 현재 내용으로 커밋 또는 Amend                  |
| `Shift` + `↑` / `↓`  | 선택 범위 확장                             |
| `Shift` + 클릭         | 범위 선택                                |
| `Cmd/Ctrl` + 클릭      | 개별 항목 추가/제외 선택                       |
| `Esc`                | 파일 선택 해제                             |

스테이지·스테이지 해제·토글은 여러 파일을 선택하면 선택 전체에 적용됩니다. 폴더만 선택했거나 충돌 파일을 선택했거나 작업이 진행 중이면 실행되지 않습니다. 커밋 **요약(Summary)**·**설명(Description)** 입력란처럼 텍스트 입력에 커서가 있으면 스테이지·스테이지 해제·토글은 동작하지 않고, `Cmd/Ctrl + Enter`(커밋)와 `Cmd/Ctrl + F`(검색), `Cmd/Ctrl + W`(탭/창 닫기)만 입력 중에도 실행됩니다.

## 단축키 재설정

\*\*설정 → ParalleLane → 단축키(Shortcuts)\*\*에서 명령별 단축키를 직접 다시 지정할 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/settings-shortcuts.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=c5b80ee4ca3f3c799629762a8e0e17ce" alt="워킹카피·히스토리·뷰·탭 카테고리별 명령과 현재 단축키 칩이 나열된 단축키 설정 화면" width="2906" height="1784" data-path="images/settings-shortcuts.png" />
</Frame>

명령은 네 카테고리로 나뉘며, 재지정할 수 있는 명령은 다음 9개입니다. 아래 표의 카테고리·명령·설명은 패널에 표시되는 앱 라벨을 그대로 옮긴 것입니다. 카테고리 이름이 "워킹카피"로 붙여 쓰여 있는 것도 앱 표기이며, 이 문서의 본문 서술에서는 "워킹 카피"로 씁니다.

| 카테고리  | 명령       | 기본값                        | 설명                            |
| ----- | -------- | -------------------------- | ----------------------------- |
| 워킹카피  | 워킹카피 열기  | `Cmd/Ctrl` + `Shift` + `C` | 뷰를 워킹카피로 전환합니다.               |
| 워킹카피  | 커밋       | `Cmd/Ctrl` + `Enter`       | 스테이지된 변경을 커밋합니다.              |
| 워킹카피  | 파일 스테이지  | `Cmd/Ctrl` + `S`           | 선택한 파일을 스테이지합니다.              |
| 워킹카피  | 파일 언스테이지 | `Cmd/Ctrl` + `U`           | 선택한 파일을 언스테이지합니다.             |
| 워킹카피  | 스테이지 토글  | `Space`                    | 선택한 파일의 스테이지 상태를 토글합니다.       |
| 히스토리  | 실행 취소    | `Cmd/Ctrl` + `Z`           | 마지막 변경을 실행 취소합니다.             |
| 히스토리  | 다시 실행    | `Cmd/Ctrl` + `Shift` + `Z` | 취소한 변경을 다시 실행합니다.             |
| 뷰     | 검색       | `Cmd/Ctrl` + `F`           | 검색 바를 엽니다.                    |
| 탭 · 창 | 탭 / 창 닫기 | `Cmd/Ctrl` + `W`           | 활성 탭을 닫습니다(그래프 탭에서는 창을 닫습니다). |

<Steps>
  <Step title="칩 클릭">
    바꾸려는 명령 오른쪽의 키캡 칩을 클릭합니다. 칩이 **키를 누르세요… (Esc 취소)** 로 바뀌며 캡처 모드가 됩니다.
  </Step>

  <Step title="새 키 입력">
    원하는 조합을 누릅니다. 수식자만 누르는 동안에는 계속 대기하고, `Esc`를 누르면 취소됩니다. 지정할 수 있는 키는 알파벳과 `Enter`, `Space`이며 수식자는 `Cmd/Ctrl`·`Shift`·`Alt`를 조합할 수 있습니다.
  </Step>

  <Step title="결과 확인">
    유효한 조합이면 즉시 저장되고 칩이 새 값으로 바뀝니다. 바뀐 행에는 마우스를 올렸을 때 되돌리기 아이콘이 나타나며, 누르면 그 명령만 기본값으로 돌아갑니다.
  </Step>
</Steps>

거절되는 입력은 행 안에 붉은 안내로 표시됩니다(스크린리더에도 즉시 읽히도록 알림으로 처리됩니다).

| 상황                                            | 표시                                   |
| --------------------------------------------- | ------------------------------------ |
| 시스템 메뉴가 예약한 조합(`⌘Q`·`⌘M`·`⌘C`·`⌘V`·`⌘X`·`⌘A`) | "시스템 메뉴가 예약한 단축키입니다."                |
| 이미 다른 명령이 쓰고 있는 조합                            | `이미 "커밋"에 할당됨.` 처럼 충돌 대상 명령을 알려 줍니다. |

수식자 없는 단일 알파벳 키로 지정하면 저장은 되지만 "수식자 없는 단일 키는 예기치 않게 발동될 수 있습니다." 경고가 함께 표시됩니다.

패널 맨 아래 **전체 기본값 복원** 버튼을 누르면 모든 재지정이 한 번에 사라집니다. 화살표·`Enter`·`Space`처럼 문맥 탐색에 쓰는 키는 재지정할 수 없으며, 패널 아래쪽 **탐색 키 (참조)** 섹션에 참고용으로만 나열됩니다.

| 참조 항목              | 키                                 |
| ------------------ | --------------------------------- |
| 커밋 선택 이동           | `↑` `↓`                           |
| 파일 트리 이동 / 접기·펴기   | `↑` `↓` `←` `→`                   |
| 행 열기 / 선택          | `Enter` / `Space`                 |
| 검색 바: 다음 / 이전 / 닫기 | `Enter` / `Shift + Enter` / `Esc` |

<Note>
  재지정한 단축키는 이 기기의 브라우저 저장소(localStorage)에만 저장됩니다. 다른 기기와 동기화되지 않으며, 앱 업데이트로 명령이 없어지면 해당 재지정은 무시됩니다.
</Note>

## 리스트와 트리 탐색

커밋 그래프, 변경 파일 목록과 워킹 카피 목록에 포커스가 있을 때 동작합니다.

| 단축키       | 동작                     |
| --------- | ---------------------- |
| `↑` / `↓` | 이전 / 다음 항목으로 이동        |
| `→`       | 접힌 폴더 펼치기 또는 첫 자식으로 이동 |
| `←`       | 펼쳐진 폴더 접기 또는 부모 폴더로 이동 |
| `Enter`   | 파일 diff 또는 머지 에디터 열기   |

파일 목록의 화살표 이동은 단일 미리보기 탭을 갱신하고, `Enter`는 고정 탭으로 엽니다. 그래프에서는 선택된 커밋의 상세 패널을 갱신합니다.

## 전체 선택과 편집기

`Cmd/Ctrl + A`는 포커스 위치에 따라 다르게 동작합니다.

* 입력창: 입력한 텍스트 전체 선택
* diff 뷰어: 복사용 diff 전체 선택
* 워킹 카피의 **스테이지 안됨** 또는 **스테이지됨** 선택: 같은 섹션의 파일 전체 선택
* 그 외: 앱 전체 텍스트가 잡히지 않도록 아무 동작도 하지 않음

`.gitignore` 편집 탭에서는 `Cmd/Ctrl + S`로 저장합니다. 편집기에 커서가 있는 동안에는 같은 키가 파일 스테이지로 동작하지 않습니다.

## 마우스

| 입력               | 동작               |
| ---------------- | ---------------- |
| 사이드 버튼(뒤로/앞으로)   | 탭 방문 히스토리 뒤로/앞으로 |
| 가운데 클릭(탭)        | 탭 닫기             |
| 더블클릭(그래프 커밋/브랜치) | 해당 참조로 체크아웃      |
| 더블클릭(서브모듈)       | 자식 저장소로 열기       |
| 더블클릭(stash)      | stash 즉시 적용      |

<Note>
  마우스 뒤로/앞으로 버튼은 인접 탭이 아니라 실제 방문 순서를 따라갑니다. 모달이나 설정 화면이 열려 있으면 동작하지 않습니다.
</Note>

## Esc 우선순위

`Esc`는 가장 위에 있는 UI부터 처리합니다. 드롭다운 → 모달 → 워킹 카피 선택 → 설정 화면 순으로 닫거나 해제합니다. Git 작업이 실행 중인 모달에서는 안전을 위해 무시될 수 있습니다.