> ## 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 설치와 설치 후 자동 업데이트·커맨드 라인 도구 설정

<Note>
  다운로드 링크는 준비 중입니다.
  현재 배포 형태는 **macOS용 DMG** 하나이며, 이 페이지의 안내도 macOS 기준입니다.
</Note>

## 시스템 요건

<CardGroup cols={2}>
  <Card title="macOS" icon="monitor">
    DMG를 열어 앱을 응용 프로그램 폴더에 넣습니다.
  </Card>

  <Card title="Git (필수)" icon="git-branch">
    체크아웃·커밋·푸시 같은 쓰기 작업은 시스템의 `git` 명령으로 실행합니다.
    터미널에서 `git --version` 이 동작하는지 확인하세요.
  </Card>
</CardGroup>

## 자동 업데이트

앱을 켠 뒤 약 6초가 지났을 때 한 번, 그다음에는 6시간마다 백그라운드에서 새 버전을 확인합니다.

<Steps>
  <Step title="알림 토스트가 뜹니다">
    새 버전을 찾으면 우측 하단에 **ParalleLane … 사용 가능** 토스트가 나타납니다.
    **자세히(Details)** 를 누르면 업데이트 다이얼로그가 열립니다.
    같은 버전 알림은 24시간 동안 다시 뜨지 않습니다.
  </Step>

  <Step title="설치합니다">
    다이얼로그에서 **릴리스 노트 보기** 로 변경 내역을 확인하고, **설치하고 재시작** 을 누르면 다운로드 후 앱이 다시 시작됩니다.
  </Step>

  <Step title="직접 확인합니다">
    **설정 → ParalleLane → 일반(General)** 의 **업데이트(Updates)** 에서 현재 버전과 마지막 확인 시각을 보고, **업데이트 확인** 으로 즉시 확인할 수 있습니다.
    **자동으로 업데이트 확인** 토글을 끄면 백그라운드 확인을 멈춥니다.
  </Step>
</Steps>

<Note>
  백그라운드 확인이 실패하면 알림이 뜨지 않습니다.
  오류 메시지는 직접 **업데이트 확인** 을 눌렀을 때만 표시됩니다.
</Note>

<Warning>
  설치가 계속 실패하면 앱을 응용 프로그램 폴더로 옮긴 뒤 다시 시도하세요.
  앱 번들에 쓰기 권한이 없으면 설치가 막힙니다.
</Warning>

## 커맨드 라인 도구

터미널에서 저장소를 바로 열려면 `parallelane` 명령을 설치합니다.

<Steps>
  <Step title="명령을 설치합니다">
    **설정 → ParalleLane → 일반(General)** 의 **커맨드 라인(Command line)** 에서 **설치(Install)** 를 누릅니다.
    관리자 권한이 필요하면 시스템 인증 창이 나타납니다.
    설치 후에는 버튼이 **제거(Uninstall)** 로 바뀌고, 아래 줄에 설치 경로가 표시됩니다.
  </Step>

  <Step title="터미널에서 저장소를 엽니다">
    `parallelane .` 처럼 실행하면 그 경로가 속한 저장소가 열립니다.
    경로를 생략하면 현재 폴더를 사용하고, Git 저장소가 아니면 오류를 냅니다.
  </Step>
</Steps>

<Warning>
  설치된 명령은 그 시점의 앱 위치를 가리킵니다.
  앱을 다른 폴더로 옮겼다면 다시 설치하세요.
  macOS에서만 지원됩니다.
</Warning>

## 다음 단계

<CardGroup cols={2}>
  <Card title="빠른 시작" icon="rocket" href="/ko/quickstart">
    온보딩부터 첫 커밋까지.
  </Card>

  <Card title="화면 둘러보기" icon="layout-dashboard" href="/ko/interface-overview">
    주요 화면 영역의 역할.
  </Card>
</CardGroup>