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

# Open In

> 워크트리를 외부 앱으로 여는 메뉴 구성

Open In은 지금 선택한 워크트리의 디렉터리를 Finder·터미널·직접 등록한 앱으로 여는 기능입니다. 메뉴에 무엇을 보여줄지는 전역 목록 하나로 정하고, 필요하면 저장소별로 다른 목록을 쓸 수 있습니다.

## 어디서 여는가

상단 바 오른쪽 끝의 분할 버튼입니다. 아이콘 버튼과 그 옆 화살표 버튼 두 개로 이루어져 있습니다.

* **화살표 버튼** — **다음에서 열기…** 메뉴를 펼칩니다.
* **아이콘 버튼** — 마지막으로 고른 항목을 한 번 눌러 다시 실행합니다. 버튼의 아이콘과 툴팁도 그 항목에 맞게 바뀌어, `Warp에서 열기`·`경로 복사`·`원격 열기` 처럼 표시됩니다.

마지막 선택은 앱을 다시 켜도 유지됩니다. 저장소별로 기억하지는 않고 앱 전체에 하나만 기억하며, 기억해 둔 항목이 목록에서 사라졌으면 메뉴의 첫 항목으로 되돌아갑니다.

<Note>
  Open In은 상단 바에만 있습니다. 사이드바나 커밋 그래프의 우클릭 메뉴에는 **다음에서 열기…** 항목이 없습니다. 또한 워크트리를 하나 선택한 상태에서만 버튼이 나타납니다.
</Note>

상단 바의 다른 버튼들은 [화면 둘러보기](/interface-overview)에서 함께 설명합니다.

## 기본 항목

**기본 항목(Default entries)** 은 앱에 내장된 네 개입니다. 삭제할 수 없고, 토글을 끄면 메뉴에서 숨겨집니다. 메뉴에는 항상 아래 순서로 나타납니다.

| 항목       | 동작                                                                                                |
| -------- | ------------------------------------------------------------------------------------------------- |
| Finder   | 워크트리 디렉터리를 파일 탐색기로 엽니다. macOS에서는 `Finder`, Windows에서는 `Explorer`, Linux에서는 `Files` 라는 이름으로 표시됩니다. |
| Terminal | 워크트리 디렉터리를 작업 디렉터리로 삼아 터미널을 엽니다.                                                                  |
| 원격 열기    | 저장소의 웹 주소를 알아낼 수 있을 때, 브라우저에서 원격 저장소 페이지를 엽니다.                                                    |
| 경로 복사    | 워크트리 디렉터리 경로를 클립보드에 복사합니다. 복사되면 메뉴 항목에 체크가 약 1.5초간 표시된 뒤 메뉴가 닫힙니다.                                |

<Note>
  **원격 열기** 는 토글이 켜져 있어도 저장소에서 열 웹 주소를 알아낼 수 있을 때만 메뉴에 나타납니다. 원격 저장소 주소를 알 수 없는 저장소에서는 항목 자체가 빠집니다.
</Note>

설치된 앱을 자동으로 찾아 메뉴에 넣는 동작은 없습니다. Finder·Terminal 외의 앱은 모두 직접 추가해야 합니다.

## 전역 목록 편집

**설정 → ParalleLane → Open In** 에서 모든 저장소가 공유하는 기본 목록을 편집합니다. 이 화면은 요금제와 무관하게 누구나 쓸 수 있고, 토글을 바꾸거나 앱을 추가·삭제하면 별도 저장 버튼 없이 즉시 저장됩니다.

* **기본 항목(Default entries)** — 네 항목의 토글. "삭제할 수 없습니다 — 끄면 메뉴에서 숨겨집니다."
* **추가한 앱(Added apps)** — 직접 등록한 앱 목록. 하나도 없으면 "추가한 앱이 없습니다."가 표시됩니다.

<Note>
  설정이 아직 불려오지 않은 동안에는 토글과 **앱 추가** 버튼이 비활성 상태입니다. 불러오기가 실패한 상태에서 편집을 허용하면 빈 기본값이 그대로 저장되어 기존 설정을 덮어쓰기 때문입니다. 저장에 실패하면 **설정 실패** 토스트가 표시됩니다.
</Note>

## 앱 추가하기

<Steps>
  <Step title="Open In 설정 열기">
    **설정 → ParalleLane → Open In** 으로 이동합니다.
  </Step>

  <Step title="앱 추가">
    **추가한 앱(Added apps)** 행의 **앱 추가** 버튼을 누릅니다. `/Applications` 에서 시작하는 파일 선택 창이 열리고 애플리케이션(`.app`)만 고를 수 있습니다.
  </Step>

  <Step title="이름 확인">
    선택한 경로의 파일명에서 확장자를 뗀 값이 이름으로 들어갑니다(`/Applications/Warp.app` → `Warp`). 이름 입력란을 고쳐 원하는 대로 바꿀 수 있고, 입력란에서 포커스가 빠질 때 반영됩니다. 이름을 비우면 이전 이름이 유지됩니다.
  </Step>

  <Step title="아이콘 선택">
    이름 왼쪽의 아이콘 버튼(**아이콘 변경**)을 눌러 메뉴에 쓸 아이콘을 고릅니다.
  </Step>
</Steps>

행 오른쪽에는 선택한 앱의 전체 경로가 표시되고, 그 옆 휴지통 버튼(**삭제**)으로 목록에서 제거합니다. 추가한 앱은 기본 항목 다음에, 추가한 순서대로 메뉴에 나열됩니다.

<Warning>
  앱 선택 창은 macOS 기준으로 만들어져 있습니다(`/Applications` 시작 경로, `.app` 확장자 필터). 실행 자체는 macOS에서 `open -a`, 그 외 OS에서는 고른 실행 파일을 직접 실행하는 방식으로 나뉘어 있지만, 다른 OS에 맞춘 선택 창은 아직 제공하지 않습니다.
</Warning>

<Note>
  등록되는 값은 선택한 시점의 앱 경로입니다. 앱을 다른 위치로 옮기거나 삭제하면 실행이 실패하므로, 그때는 항목을 삭제하고 다시 추가하세요.
</Note>

## 아이콘 고르기

아이콘은 앱에서 미리 준비한 20개 중에서 고릅니다. 앱의 실제 아이콘을 읽어오지는 않습니다. 아이콘 버튼을 누르면 작은 그리드 팝오버가 열리고, 하나를 누르면 바로 적용되며 팝오버가 닫힙니다.

고를 수 있는 아이콘은 순서대로 `play`, `terminal`, `terminal-square`, `code`, `file-code`, `file-text`, `folder`, `folder-open`, `globe`, `compass`, `book`, `database`, `pencil`, `image`, `music`, `bug`, `box`, `wrench`, `rocket`, `zap` 입니다. 새로 추가한 앱의 기본값은 `play` 입니다.

기본 항목의 아이콘은 고를 수 없습니다. Finder는 폴더, Terminal은 터미널, **경로 복사** 는 복사 아이콘으로 고정되고, **원격 열기** 는 호스트 종류(GitHub·GitLab 등)에 맞는 아이콘, 알 수 없으면 지구 아이콘으로 표시됩니다.

## 저장소별 설정과 우선순위

**설정 → 프로젝트(Projects) → Open In** 에서 상단 프로젝트 드롭다운으로 저장소를 고른 뒤, **프로젝트 Open In** 행의 **상속 / 재정의** 를 선택합니다.

<CardGroup cols={2}>
  <Card title="상속" icon="globe">
    "이 프로젝트는 전역 Open In 목록을 사용합니다." 전역 목록을 그대로 쓰고, 편집할 목록이 따로 표시되지 않습니다.
  </Card>

  <Card title="재정의" icon="folder-cog">
    "이 프로젝트는 자체 Open In 목록을 사용합니다." 이 저장소만의 목록이 아래에 나타나고, 전역 목록과 같은 방식으로 편집합니다.
  </Card>
</CardGroup>

우선순위는 단순합니다. **재정의가 있으면 그 목록만 쓰고 전역 목록은 무시합니다.** 두 목록이 합쳐지지 않으므로, 전역에 나중에 추가한 앱이 재정의를 쓰는 저장소에 자동으로 따라 들어오지는 않습니다.

* **상속 → 재정의** 로 바꾸면 그 순간의 전역 목록을 복사해 저장소 목록의 출발점으로 삼습니다. 빈 목록에서 시작하지 않습니다.
* **재정의 → 상속** 으로 되돌리면 저장소 목록이 삭제되고 다시 전역 목록을 따릅니다. 되돌린 뒤 다시 재정의하면 그때의 전역 목록을 새로 복사합니다.

<Note>
  전환 버튼은 저장소의 재정의 여부를 확인하기 전까지, 그리고 전환 처리 중에는 비활성 상태입니다. 확인 전 상태를 "상속"으로 오인해 전환하면 이미 있는 저장소 목록을 덮어쓸 수 있기 때문입니다.
</Note>

## 요금제 제약

전역 목록은 모든 요금제에서 편집할 수 있습니다. **저장소별 재정의만 Pro 기능**입니다.

* Basic에서는 **프로젝트 Open In** 제목에 **PRO** 배지가 붙고, **재정의** 를 누르면 "프로젝트별 Open In 목록은 Pro 기능입니다." 안내와 **플랜 보기** 버튼이 담긴 토스트가 표시됩니다. 재정의는 만들어지지 않습니다.
* 이미 재정의를 만들어 둔 저장소는 Pro에서 Basic으로 내려간 뒤에도 계속 편집할 수 있습니다(grandfathering). 막히는 것은 **새 재정의를 만드는** 동작뿐입니다.
* **상속** 으로 되돌리는 방향에는 요금제 검사가 없습니다. 다만 되돌린 뒤 Basic에서 다시 재정의하려면 막힙니다.

요금제별 차이 전체는 [요금제 & 라이선스](/settings/plan-license)에서 확인하세요.

## 알아 둘 점

<AccordionGroup>
  <Accordion title="메뉴 순서는 바꿀 수 없습니다" icon="arrow-down-up">
    기본 항목 네 개가 고정 순서로 먼저 오고, 그 뒤에 추가한 앱이 등록 순서대로 붙습니다. 끌어서 순서를 바꾸는 기능은 없습니다. 순서를 바꾸려면 앱을 삭제하고 원하는 순서로 다시 추가해야 합니다.
  </Accordion>

  <Accordion title="모두 숨기면 버튼이 사라집니다" icon="eye-off">
    기본 항목 네 개를 모두 끄고 추가한 앱도 없으면 메뉴에 남는 항목이 없어, 상단 바에서 Open In 버튼 자체가 표시되지 않습니다. 항목을 하나라도 다시 켜면 버튼이 돌아옵니다.
  </Accordion>

  <Accordion title="열리는 대상은 워크트리 디렉터리입니다" icon="folder-tree">
    선택한 파일이나 커밋이 아니라, 지금 선택한 워크트리의 디렉터리 경로를 넘깁니다. 기본 워크트리를 보고 있으면 저장소 디렉터리, 연결된(linked) 워크트리를 보고 있으면 그 워크트리의 디렉터리가 열립니다.
  </Accordion>

  <Accordion title="설정 화면 자체의 구조" icon="settings">
    설정 화면의 탭 구성과 다른 메뉴는 [설정](/settings/preferences)에서 함께 설명합니다.
  </Accordion>
</AccordionGroup>