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

# 브랜치 & 태그

> 브랜치·태그 생성/이름변경/삭제, 스마트 그룹으로 정리

브랜치와 태그는 커밋 그래프에서 커밋을 **우클릭**해 관리합니다.
배지가 붙은 커밋에서는 그 브랜치·태그별 서브메뉴로 이름 변경과 삭제까지 할 수 있습니다.

<Note>
  저장소(Repository) 패널의 행을 우클릭해도 같은 다이얼로그를 열 수 있습니다.
  다만 **생성** 은 기준 커밋을 골라야 하므로 그래프에서만 가능합니다.
</Note>

## 브랜치 만들기

기준이 될 커밋을 우클릭하고 **브랜치 만들기…** 를 선택합니다.
**브랜치 이름(Branch name)** 을 입력하고 **만들기(Create)** 를 누릅니다.
**생성 후 체크아웃(Checkout after creating)** 토글은 기본으로 켜져 있습니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/history-branch-create.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=7b6af5869f51ce02f615b16fb7f09a5d" alt="기준 커밋에서 새 브랜치를 만드는 다이얼로그 — 이름 입력창과 생성 후 체크아웃 토글" width="886" height="480" data-path="images/history-branch-create.png" />
</Frame>

## 브랜치 이름 변경

브랜치 배지가 붙은 커밋을 우클릭하고 해당 브랜치 서브메뉴에서 **이름 변경…** 을 선택합니다.
입력창에는 현재 이름이 채워져 있고, 원격에 올라가 있는 브랜치라면 **원격에서도 이름 변경(Also rename on remote)** 토글이 나타납니다(기본 꺼짐).

<Note>
  * 현재 체크아웃 중인 브랜치도 이름을 바꿀 수 있습니다.
  * 원격 변경은 "새 이름 push → 성공 시 옛 이름 삭제" 순서로 진행됩니다.
  * 원격 전용 브랜치는 이름 변경 대상이 아닙니다.
</Note>

## 브랜치 삭제

브랜치 서브메뉴에서 **삭제** 를 선택합니다.
확인 모달의 **원격에서도 삭제(Also delete on remote)** 토글로 원격 브랜치까지 지울 수 있습니다.

<Warning>
  현재 체크아웃 중인 브랜치는 삭제할 수 없습니다.

  병합되지 않은 커밋이 남은 브랜치는 Git이 삭제를 거부합니다.
  이때 에러 알림의 **강제 삭제** 버튼을 누르면 확인 없이 곧바로 삭제되며, 다른 브랜치에 없는 커밋은 유실될 수 있습니다.
</Warning>

## 태그 만들기

커밋을 우클릭하고 **태그 만들기…** 를 선택합니다.

* **제목(Title)** — 태그 이름. 필수입니다.
* **설명 (선택)** — 비우면 lightweight 태그, 채우면 annotated 태그가 됩니다.
* **원격(origin)에 푸시** — 켜면 만들면서 원격에도 올립니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/history-tag-create.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=fef2123579d4c72bbf7bcc5df4e8116d" alt="태그 이름과 설명(선택)을 입력하고 원격 푸시 여부를 고르는 태그 만들기 다이얼로그" width="886" height="624" data-path="images/history-tag-create.png" />
</Frame>

## 태그 삭제

태그 배지가 붙은 커밋을 우클릭하고 태그 서브메뉴에서 **삭제** 를 선택합니다.
**원격에서도 삭제(Also delete on remote)** 를 켜면 설정된 원격 모두에 삭제를 시도하며, 태그가 없는 원격에서는 Git 에러가 알림으로 표시됩니다.

## 브랜치와 태그를 그룹으로 정리하기

<Info>
  **PRO 전용** — 그룹의 **이 저장소** 범위는 Pro 기능입니다.
  **전역** 범위는 모든 요금제에서 사용할 수 있습니다. [요금제](/ko/quickstart#요금제)
</Info>

**스마트 그룹** 은 이름이 패턴에 맞는 ref를 자동으로 한 묶음에 모읍니다.
패턴만 정해 두면 나중에 생긴 ref도 저절로 들어갑니다.
저장소(Repository) 패널의 **로컬 브랜치**, **원격 브랜치**, **태그** 세 섹션이 각각 독립된 그룹 목록을 가집니다.

<Note>
  그룹은 화면 정리 전용이며 앱 안에만 저장됩니다.
  git 저장소나 원격에는 영향이 없습니다.
</Note>

### 그룹 만들기

<Steps>
  <Step title="섹션 헤더에서 새 그룹 열기">
    섹션 헤더에 마우스를 올리면 나타나는 **＋** 버튼(**새 그룹**)을 누릅니다.
    그룹이 하나 이상 있으면 그 왼쪽에 톱니 버튼(**그룹 관리**)도 함께 나타납니다.

    <Tip>
      이 버튼들은 섹션 헤더에 마우스를 올릴 때만 드러납니다.
    </Tip>
  </Step>

  <Step title="이름과 매칭 패턴 입력">
    **그룹 이름**(예: `릴리스`)과 **매칭 패턴 (글롭)**(예: `release/*`)을 입력합니다.
  </Step>

  <Step title="범위 고르고 생성">
    **범위(Scope)** 에서 **전역(Global, 기본값)** 은 모든 저장소에, **이 저장소(This repo)** 는 현재 저장소에만 적용합니다.
    **생성(Create)** 을 누르면 패턴에 맞는 ref가 곧바로 모입니다.
  </Step>
</Steps>

### 매칭 패턴 (글롭)

패턴은 ref 이름 **전체와 일치**해야 하며 대소문자는 구분하지 않습니다.
`*` 는 임의 길이의 문자열(`/` 포함), `?` 는 한 글자입니다.

비교 대상은 섹션마다 다릅니다.

* **로컬 브랜치** — 브랜치 이름 (`feature/login`)
* **원격 브랜치** — 원격 이름을 포함한 전체 (`origin/feature/login`)
* **태그** — 태그 이름 (`v1.2.0`)

<Tip>
  원격 브랜치 섹션에서는 `feature/*` 가 아니라 `*/feature/*` 또는 `origin/feature/*` 로 써야 걸립니다.
</Tip>

<Note>
  하나의 ref는 한 그룹에만 들어갑니다.
  여러 패턴에 걸리면 **이 저장소 전용 그룹 → 전역 그룹** 순으로 먼저 확인된 그룹이 가져가며, 같은 범위에서는 목록 순서를 따릅니다.
  좁은 패턴을 위로 두는 편이 예측하기 쉽습니다.
</Note>

어떤 그룹에도 걸리지 않은 ref는 원래 자리에 그대로 남습니다.

### 그룹 다루기

* 그룹 헤더에는 접기 화살표, 그룹 이름, 매칭된 개수가 표시됩니다.
  헤더를 클릭하면 접거나 펼칩니다.
* 헤더를 우클릭하면 **그룹 편집… / 위로 / 아래로 / 삭제** 메뉴가 열립니다.
  편집에서는 이름·패턴과 범위를 모두 바꿀 수 있습니다.
* 섹션 헤더의 **그룹 관리** 버튼을 누르면 그 섹션의 모든 그룹을 한 화면에서 정렬·편집·삭제할 수 있습니다.
  순서 이동은 같은 범위 안에서만 이뤄집니다.
* 매칭이 0개인 그룹도 개수 0으로 계속 표시됩니다.

<Warning>
  그룹 **삭제** 는 확인 절차 없이 처리됩니다.
  그룹만 없어지고 브랜치·태그는 원래 목록으로 돌아옵니다.
</Warning>