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

# 단축키

> 키보드 단축키, 마우스 동작, 단축키 재설정

앱의 모든 키보드·마우스 단축키를 모았습니다.
macOS에서는 `Cmd`, Windows·Linux에서는 `Ctrl` 을 사용합니다.

## 전역

| 단축키                        | 동작                     |
| -------------------------- | ---------------------- |
| `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`     | 선택한 파일을 스테이지    |
| `Cmd/Ctrl` + `U`     | 선택한 파일을 스테이지 해제 |
| `Space`              | 스테이지 상태 전환      |
| `Cmd/Ctrl` + `Enter` | 커밋 또는 Amend     |
| `Esc`                | 선택 해제           |

여러 파일을 선택하면 선택 전체에 적용됩니다.
폴더만 선택했거나 충돌 파일을 선택했으면 실행되지 않고, 텍스트 입력에 커서가 있으면 `Cmd/Ctrl + Enter`·`Cmd/Ctrl + F`·`Cmd/Ctrl + W` 만 동작합니다.

## 선택과 탐색

커밋 그래프, 변경 파일 목록, 워킹 카피 목록에서 동작합니다.

| 단축키                 | 동작                     |
| ------------------- | ---------------------- |
| `Shift` + 클릭        | 범위 선택                  |
| `Cmd/Ctrl` + 클릭     | 개별 항목 추가/제외            |
| `Shift` + `↑` / `↓` | 선택 범위 확장               |
| `↑` / `↓`           | 이전 / 다음 항목             |
| `→`                 | 접힌 폴더 펼치기 또는 첫 자식으로 이동 |
| `←`                 | 펼쳐진 폴더 접기 또는 부모로 이동    |
| `Enter`             | 파일 diff 또는 머지 에디터 열기   |

파일 목록의 화살표 이동은 단일 미리보기 탭을 갱신하고, `Enter` 는 고정 탭으로 엽니다.
그래프의 다중 선택은 스쿼시와 여러 커밋 cherry-pick의 대상이 됩니다.

## 검색 바

그래프와 diff 검색 모두 같은 키를 씁니다.

| 단축키               | 동작                        |
| ----------------- | ------------------------- |
| `Cmd/Ctrl` + `F`  | 검색 열기(이미 열려 있으면 입력창에 포커스) |
| `Enter`           | 다음 일치                     |
| `Shift` + `Enter` | 이전 일치                     |
| `Esc`             | 검색 닫기                     |

## 전체 선택과 편집기

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

* 입력창 — 입력한 텍스트 전체 선택
* diff 뷰어 — diff 전체 선택. 이어서 `Cmd/Ctrl` + `C` 로 복사하면 표준 diff 텍스트가 들어갑니다.
* 워킹 카피 — 같은 섹션의 파일 전체 선택
* 그 외 — 아무 동작도 하지 않음

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

## 마우스

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

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

## Esc 우선순위

`Esc` 는 가장 위에 있는 UI부터 처리합니다 — 드롭다운 → 모달 → 워킹 카피 선택 → 설정 화면. Git 작업이 실행 중인 모달에서는 무시될 수 있습니다.

## 단축키 재설정

**설정 → ParalleLane → 단축키(Shortcuts)** 에서 아래 9개 명령의 키를 다시 지정할 수 있습니다.

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

| 카테고리  | 명령       | 기본값                        |
| ----- | -------- | -------------------------- |
| 워킹카피  | 워킹카피 열기  | `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`           |

명령 오른쪽의 키캡 칩을 클릭하면 **키를 누르세요… (Esc 취소)** 로 바뀝니다.
조합을 누르면 즉시 저장되고, 바뀐 행에 마우스를 올리면 나타나는 되돌리기 아이콘으로 그 명령만 기본값으로 돌립니다.
지정할 수 있는 키는 알파벳과 `Enter`, `Space` 이며 수식자는 `Cmd/Ctrl`·`Shift`·`Alt` 를 조합합니다.

거절되는 입력은 행 안에 붉은 안내로 표시됩니다.

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

수식자 없는 단일 키는 저장되지만 경고가 함께 표시됩니다.
패널 맨 아래 **전체 기본값 복원** 으로 모든 재지정을 되돌립니다.
화살표·`Enter`·`Space` 처럼 문맥 탐색에 쓰는 키는 재지정할 수 없고, **탐색 키 (참조)** 섹션에 참고용으로만 나열됩니다.

<Note>
  재지정한 단축키는 이 기기에만 저장되며 다른 기기와 동기화되지 않습니다.
</Note>
