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

# 워크트리별 상태

> 워크트리별 독립 상태와 표시

각 워크트리는 자신만의 커밋 그래프, 저장소 개요, 변경·충돌 상태를 독립적으로 유지합니다.

## 우측 사이드바의 워킹 카피 카드

우측 사이드바 최상단에는 **워킹 카피(Working copy)** 진입 카드가 항상 놓여 있습니다.
커밋 상세를 보고 있어도 사라지지 않고, 클릭하면 워킹 카피 패널로 들어갑니다.
카드는 다음 우선순위로 상태를 표시합니다.

<Steps>
  <Step title="머지 충돌이 있으면 — 충돌 개수">
    점이 빨강으로 채워지고 `3개 충돌` 처럼 표시됩니다.

    <Frame>
      <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/worktree-status-conflict.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=d1ec4e5c94cf28b070dc85e66c75a8dc" alt="우측 사이드바 최상단의 워킹 카피 카드가 빨강 점과 충돌 개수를 보여 주고, 그 아래로 충돌 파일이 있는 워킹 카피 패널이 열려 있다" width="2386" height="1784" data-path="images/worktree-status-conflict.png" />
    </Frame>
  </Step>

  <Step title="변경사항이 있으면 — 변경 개수">
    점이 amber로 채워지고 `5개 변경` 처럼 표시됩니다.
    개수는 staged·unstaged·untracked를 모두 더한 값입니다.

    <Frame>
      <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/worktree-status-changes.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=6751d17bb05a3869ae73f6dd30ba7e18" alt="우측 사이드바 최상단의 워킹 카피 카드가 amber 점과 변경 개수를 보여 주고, 그 아래로 변경 파일이 나열된 워킹 카피 패널이 열려 있다" width="2386" height="1784" data-path="images/worktree-status-changes.png" />
    </Frame>
  </Step>

  <Step title="둘 다 없으면 — 변경 없음">
    점이 빈 링으로 바뀌고 **변경 없음** 이 표시됩니다.
    이때도 클릭해 들어가 마지막 커밋을 수정(amend)할 수 있습니다.
  </Step>
</Steps>

<Note>
  카드는 **현재 선택한 워크트리 하나**만 대상으로 합니다.
  그래프 최상단의 워킹 카피 행, 워킹 카피 패널, 이 카드는 같은 상태를 공유하므로 스테이징·되돌리기를 하면 개수가 즉시 갱신됩니다.
</Note>

## 워크트리마다 독립적으로 유지되는 것들

<CardGroup cols={2}>
  <Card title="커밋 그래프" icon="git-branch">
    워크트리별로 따로 계산·캐시되어 전환 시 빠르게 다시 나타납니다.
  </Card>

  <Card title="저장소 개요" icon="list-tree">
    로컬·원격 브랜치, 태그, 스태시 목록도 워크트리 단위로 캐시됩니다.
  </Card>

  <Card title="워킹 카피 상태" icon="file-diff">
    스테이징·변경·충돌 상태가 독립적으로 추적됩니다.
  </Card>

  <Card title="그래프 스코프 토글" icon="filter">
    "현재 브랜치만 / 모든 브랜치" 선택이 워크트리별로 저장됩니다.
  </Card>
</CardGroup>

<Note>
  단, **열린 탭**은 다릅니다.
  다른 워크트리로 전환하면 diff 탭이 닫히고 **히스토리(History)** 탭 하나로 초기화됩니다.
  [생성·전환·삭제](/ko/worktrees/managing)를 참고하세요.
</Note>

### 그래프 스코프: 현재 브랜치 vs 모든 브랜치

<Tabs>
  <Tab title="기본 워크트리">
    항상 **모든 브랜치**(로컬 + 원격)를 그리며, 스코프 토글 버튼이 표시되지 않습니다.
  </Tab>

  <Tab title="연결된(linked) 워크트리">
    기본은 **현재 브랜치만** 보기로, 체크아웃된 브랜치의 tip과 그 업스트림에서 도달 가능한 커밋을 그립니다.
    상단 바의 토글로 **모든 브랜치 보기** 와 전환할 수 있고, 선택은 워크트리별로 저장됩니다.
  </Tab>
</Tabs>

<Tip>
  스코프 토글은 연결된 워크트리에서 **히스토리(History) 탭**을 보고 있을 때만 나타납니다.
  툴팁은 누르면 어떻게 되는지를 알려 줍니다.
</Tip>

## 사이드바 워크트리 행 표시 규칙

| 상태           | 선두 아이콘        | 라벨                 | 꼬리 표시                        |
| ------------ | ------------- | ------------------ | ---------------------------- |
| 브랜치 있음       | 폴더 아이콘(기본/연결) | 브랜치 이름             | `↑앞섬 ↓뒤처짐`                   |
| 분리된 HEAD     | 폴더 아이콘        | 커밋 마커 + 7자리 짧은 SHA | `↑앞섬 ↓뒤처짐`                   |
| 유령(prunable) | 폴더 아이콘(흐림)    | 위 규칙 그대로(흐림)       | 유령 아이콘 + 존재하지 않음(Missing) 배지 |

앞섬/뒤처짐은 0이 아닌 쪽만 표시되고, 연결된 워크트리 행에 마우스를 올리면 이 자리에 삭제 버튼이 들어옵니다.
선두 폴더 아이콘은 기본 워크트리(폴더 체크)와 연결된 워크트리(Git 폴더)를 항상 구분합니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/worktree-row-badges.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=aa770e21f63fe2ef06b06dbcc232279f" alt="워크트리 행 클로즈업. 폴더 아이콘과 브랜치 이름 뒤로 행 오른쪽 끝에 앞섬/뒤처짐 개수가 표시되어 있다" width="518" height="72" data-path="images/worktree-row-badges.png" />
</Frame>

존재하지 않음(Missing) 배지가 붙은 워크트리는 작업 디렉터리가 사라진 유령 워크트리입니다.
정리 방법은 [점유 브랜치 & 정리](/ko/worktrees/advanced)에서 다룹니다.