> ## 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**·**프로젝트(Projects)** 두 탭으로 구성됩니다. ParalleLane 탭은 앱과 머신 전역 설정을, 프로젝트 탭은 선택한 저장소의 로컬 설정을 다룹니다.

## 설정 열기와 닫기

좌측 사이드바 하단의 설정 아이콘으로 엽니다. macOS에서는 네이티브 메뉴의 **ParalleLane → 설정…(Settings…)** 으로도 열 수 있습니다. 처음 열면 **설정 → ParalleLane → 일반(General)** 화면이 나타나며, 좌상단 **앱으로 돌아가기(Back to app)** 또는 `Esc`로 닫습니다.

<Tabs>
  <Tab title="ParalleLane">
    앱 전체에 적용되는 메뉴가 다음 순서로 놓입니다.

    **일반(General) · 디자인(Appearance) · 단축키(Shortcuts) · 계정(Accounts) · Git · 서명(Signing) · Open In · 요금제(Plan)**
  </Tab>

  <Tab title="프로젝트(Projects)">
    프로젝트 드롭다운에서 저장소를 고른 뒤 **계정(Account) · Git · 서명(Signing) · Open In**을 설정합니다. 등록된 저장소가 없으면 **프로젝트 없음** 안내가 표시됩니다.
  </Tab>
</Tabs>

<Note>설정 화면이 열려 있는 동안에는 뒤 화면의 전역 단축키와 마우스 뒤로/앞으로 버튼이 동작하지 않습니다.</Note>

## General

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/settings-general.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=8fe3be83b620c90319d2584bfb05bbe1" alt="언어, 기본 클론 위치, 소스 코드 폴더, 제외 폴더, 세션 복원, Fetch, 잘못된 워크트리, 업데이트 행이 차례로 놓인 일반 설정 화면" width="2906" height="1784" data-path="images/settings-general.png" />
</Frame>

<AccordionGroup>
  <Accordion title="언어(Language)" icon="languages">
    `English` / `한국어`를 선택합니다. 앱 화면과 macOS 네이티브 메뉴가 새로고침 없이 함께 바뀝니다.
  </Accordion>

  <Accordion title="기본 클론 위치(Default clone location)" icon="folder-down">
    원격 프로젝트를 클론할 기본 부모 폴더입니다.
  </Accordion>

  <Accordion title="소스 코드 폴더 / 제외 폴더" icon="folder-plus">
    등록한 폴더 바로 아래의 Git 저장소가 자동으로 등록됩니다. **제외 폴더**를 추가하면 해당 경로와 그 하위를 스캔하지 않습니다. **재스캔**으로 지금 다시 훑을 수 있습니다.
  </Accordion>

  <Accordion title="시작 시 마지막 세션 다시 열기" icon="rotate-ccw">
    시작할 때 저장소·워크트리·열린 탭을 복원합니다.
  </Accordion>

  <Accordion title="Fetch" icon="refresh-cw">
    포커스 또는 워크트리 전환 시 자동 fetch 여부와 최소 실행 간격을 정합니다.
  </Accordion>

  <Accordion title="잘못된 워크트리(Invalid worktrees)" icon="folder-git-2">
    디렉터리가 사라진 유령 워크트리를 **지금 정리**로 즉시 치우거나, 자동 정리를 켭니다.
  </Accordion>

  <Accordion title="업데이트(Updates)" icon="download">
    앱이 백그라운드에서 새 버전을 확인하고 설치 전에 물어봅니다.

    * 자동 확인은 앱 시작 6초 뒤에 처음 실행되고, 이후 6시간 간격으로 반복됩니다. 오른쪽 토글(**자동으로 업데이트 확인**)로 끌 수 있습니다.
    * 새 버전을 찾으면 **ParalleLane x.y.z 사용 가능** 토스트가 뜨고, **자세히**를 누르면 업데이트 다이얼로그가 열립니다. 같은 버전에 대한 알림은 24시간 안에 다시 뜨지 않습니다.
    * **업데이트 확인** 버튼으로 직접 확인할 수 있고, 확인 중에는 **확인 중…** 으로 바뀝니다. 결과는 **최신 버전입니다.** / **x.y.z 버전을 사용할 수 있습니다.** / **업데이트를 확인하지 못했습니다.** 중 하나로 표시되고, 현재 버전과 **마지막 확인** 시각이 함께 적힙니다.
    * 업데이트가 있으면 **업데이트 설치** 버튼이 나타납니다. 다이얼로그에서 **설치하고 재시작**을 누르면 다운로드 진행률이 표시되고(전체 크기를 모르면 진행률 없이 **다운로드 중…**), 설치가 끝나면 앱이 재시작됩니다.
  </Accordion>

  <Accordion title="커맨드 라인(Command Line)" icon="terminal">
    터미널에서 저장소를 열 수 있도록 `parallelane` 명령을 설치합니다. 설치하면 `parallelane .` 처럼 경로를 넘겨 저장소를 열 수 있습니다.

    * **설치**를 누르면 래퍼가 만들어지고 행 아래에 **설치됨 · 경로**가 표시됩니다. **제거**로 되돌릴 수 있습니다.
    * 앱을 다른 위치로 옮긴 뒤에는 다시 설치해야 합니다.
    * macOS 네이티브 메뉴의 \*\*커맨드 라인 도구 설치(Install Command Line Tool)\*\*도 같은 동작을 합니다.

    <Note>이 항목은 macOS에서만 표시되고 동작합니다. 다른 OS에서는 설치가 거부됩니다.</Note>
  </Accordion>

  <Accordion title="저장 공간(Storage)" icon="database">
    캐시된 커밋 그래프와 다운로드한 아바타를 삭제합니다.
  </Accordion>
</AccordionGroup>

## Appearance

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/settings-appearance.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=8b95db74fae8408b8370b556f6dd98b3" alt="색 테마와 구문 강조, UI·코드 글꼴을 선택하는 디자인 설정 화면" width="2906" height="1784" data-path="images/settings-appearance.png" />
</Frame>

디자인 화면은 **테마(Theme) · Diff · 글꼴(Fonts)** 세 묶음으로 나뉩니다.

| 항목                                | 설명                                                                |
| --------------------------------- | ----------------------------------------------------------------- |
| 색 테마(Color Theme)                 | `Espresso Dark`, `Espresso Cream`, `Caramel Macchiato` 중에서 선택합니다. |
| 구문 강조(Syntax highlighting)        | diff의 키워드·문자열·주석·숫자에 색을 적용합니다.                                    |
| UI 글꼴(UI font)                    | 시스템 폰트와 10–20px 크기를 선택합니다. 기본 크기는 13px입니다.                        |
| 터미널 / 코드 글꼴(Terminal / Code Font) | diff·그래프 영역의 고정폭 폰트와 10–20px 크기를 선택합니다. 기본 크기는 12px입니다.           |

폰트 행의 초기화 버튼은 해당 글꼴과 크기를 시스템 기본값으로 되돌립니다. 변경은 즉시 앱 전체에 적용됩니다.

## Git

**설정 → ParalleLane → Git** 메뉴는 머신 전역 Git 기본값을 다룹니다. 저장소별 리모트 설정은 이름이 같은 **설정 → 프로젝트(Projects) → Git** 메뉴에 따로 있으니 헷갈리지 마세요.

| 항목                             | 설명                                                                           |
| ------------------------------ | ---------------------------------------------------------------------------- |
| 기본 계정(Default account)         | 머신 전역 Git 신원과 인증에 사용할 계정입니다. 저장소가 `Global`을 따를 때 쓰입니다.                       |
| 모든 원격에서 가져오기 / 태그 가져오기         | Fetch 다이얼로그의 기본 선택입니다.                                                       |
| 체크아웃 시 자동 fast-forward         | 원격 추적 브랜치 체크아웃 시 가능한 경우 fast-forward합니다. 머지가 필요하면 건너뜁니다.                     |
| 기본적으로 모든 태그 push               | Push 다이얼로그에서 모든 로컬 태그를 기본 선택합니다.                                             |
| 적용 후 stash 기본 삭제               | 성공적으로 적용한 stash를 기본적으로 삭제합니다.                                                |
| 비교 뷰 Blame                     | 비교(Compare) 뷰 오른쪽에 각 줄을 마지막으로 고친 커밋을 표시합니다.                                  |
| 머지 툴(Merge tool)               | 충돌 파일을 열 외부 `git mergetool`을 선택합니다.                                          |
| Git LFS                        | git-lfs 설치·초기화 상태를 진단하고 머신 전역 LFS 필터를 초기화합니다.                                |
| 커밋 그래프 인덱스(Commit graph index) | fetch할 때 commit-graph 인덱스를 만들고 갱신해 대형 저장소의 이력 탐색을 빠르게 합니다. 다음 fetch부터 적용됩니다. |

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/settings-git.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=bb55687e76840700ede37aaa65924c66" alt="기본 계정과 fetch·push 기본값, Git LFS 상태 배지가 있는 Git 설정 화면" width="2906" height="1784" data-path="images/settings-git.png" />
</Frame>

Git LFS 행의 상태 배지와 초기화 절차는 [Git LFS](/settings/git-lfs)에서 자세히 설명합니다. 커밋 서명은 Git 화면의 토글이 아니라 별도 **서명(Signing)** 메뉴에서 설정합니다.

## 그 외 메뉴

* **단축키(Shortcuts)** — 워킹 카피·히스토리·뷰·탭 명령의 단축키를 직접 다시 지정합니다. 패널의 카테고리 라벨은 앱 표기 그대로 "워킹카피"입니다. 자세한 내용은 [단축키 & 탐색](/settings/keyboard-shortcuts)을 참고하세요.
* **계정(Accounts)** — 머신에 등록된 계정을 관리합니다. 자세한 내용은 [계정 & 인증](/settings/accounts)을 참고하세요.
* **서명(Signing)** — SSH/GPG 전역 서명 방식을 관리합니다. 자세한 내용은 [커밋 서명](/settings/commit-signing)을 참고하세요.
* **Open In** — 상단 바 드롭다운 **다음에서 열기…** 에 어떤 앱을 노출할지 관리합니다. **기본 항목**은 토글로 숨기기만 하고, **추가한 앱**에는 직접 고른 앱을 등록할 수 있습니다. 자세한 내용은 [Open In](/settings/open-in)을 참고하세요.
* **요금제(Plan)** — 현재 Basic/Pro 상태, 라이선스 키 활성화와 구매 링크를 제공합니다. 자세한 내용은 [요금제 & 라이선스](/settings/plan-license)를 참고하세요.

## 프로젝트별 설정

<AccordionGroup>
  <Accordion title="계정(Account)" icon="user">
    저장소의 커밋 신원과 인증 계정을 `Global` 또는 등록된 계정 중에서 선택합니다. 자세한 내용은 [계정 & 인증](/settings/accounts)을 참고하세요.
  </Accordion>

  <Accordion title="Git" icon="git-branch">
    **기본 remote**(앱 라벨 표기)를 지정하고 리모트를 추가·수정·삭제합니다. Push/Pull/Fetch는 이 기본값을 우선 사용합니다.
  </Accordion>

  <Accordion title="서명(Signing)" icon="file-signature">
    **전역 설정 따름** 또는 **이 레포만 설정**을 골라, 이 저장소만 안 함/SSH/GPG 방식과 키를 덮어쓸 수 있습니다. 자세한 내용은 [커밋 서명](/settings/commit-signing)을 참고하세요.
  </Accordion>

  <Accordion title="Open In" icon="external-link">
    **프로젝트 Open In** 행에서 **상속**과 **재정의**를 고릅니다. 상속이면 전역 목록을 그대로 쓰고, **재정의**로 바꾸면 전역 목록을 복사한 사본이 이 저장소에 저장됩니다. 재정의는 Pro 기능이라 Basic에서는 행 제목에 **PRO** 배지가 붙습니다. 자세한 내용은 [Open In](/settings/open-in)을 참고하세요.
  </Accordion>
</AccordionGroup>