커밋 & 푸시

파일을 스테이징하고, 직접 또는 AI 에이전트로 커밋 메시지를 작성한 뒤, 몇 번의 클릭만으로 원격 저장소에 푸시하세요.

diff를 검토하고 AI 에이전트가 변경한 내용에 만족했다면, 이제 커밋하고 푸시할 차례입니다. 이 가이드에서는 스테이징부터 원격 저장소로 푸시하기까지의 전체 워크플로를 단계별로 안내합니다.

변경 사항 스테이징

스테이징을 사용하면 이번 커밋에 포함할 변경 사항을 정확히 선택할 수 있습니다. 예를 들어 기능 코드와 설정 변경을 별도의 커밋으로 나누고 싶을 수 있습니다.

Git 패널에서 수정된 모든 파일은 Unstaged Changes 섹션에 표시됩니다.

  • 파일 옆의 체크박스를 선택하면 해당 파일만 개별적으로 스테이징됩니다
  • Stage All을 클릭하면 변경된 모든 파일을 한 번에 스테이징합니다
  • 파일을 언스테이징하려면 체크를 해제하세요. 파일이 다시 Unstaged로 이동합니다

스테이징된 파일은 사이드바 상단의 Staged Changes 섹션으로 이동합니다. 스테이징된 파일만 커밋에 포함됩니다.

파일 전체 대신 개별 hunk(파일의 일부 구간)만 스테이징할 수도 있습니다. diff 뷰에서 hunk 위에 마우스를 올리면 나타나는 + 버튼을 클릭하면 해당 구간만 스테이징됩니다. 한 파일에 서로 관련 없는 두 가지 변경이 있는데 지금은 그중 하나만 커밋하고 싶을 때 유용합니다.

폴더 트리로 변경 사항 보기

에이전트는 넓고 얕은 diff를 만들어 냅니다. 네 개의 디렉터리에 걸쳐 열여덟 개의 파일을 건드리는 변경도 흔합니다. 플랫 리스트로 보면 거의 비슷한 경로가 열여덟 줄이나 나열됩니다.

Filter 입력란 옆의 토글을 사용하면 Changes 목록을 플랫 리스트와 VS Code 스타일의 폴더 트리 사이에서 전환할 수 있으며, 선택한 보기 방식은 다음에 대화상자를 열 때도 유지됩니다.

폴더 트리 모드의 Git Changes 대화상자. 변경된 파일 18개가 scripts, src/main/database/adapters, renderer/components 아래에 중첩되어 있고, 각 디렉터리 행에 폴더별 스테이징 체크박스가 있습니다

  • 폴더 체크박스는 그 아래의 모든 항목을 한 번에 스테이징하거나 언스테이징합니다. 영역별로 검토하는 것과 영역별로 스테이징하는 것이 같은 동작이 됩니다.
  • 폴더에 표시된 대시(-)는 일부만 스테이징되었다는 뜻입니다. 부분 스테이징은 실수로 만들어지기 쉽고 플랫 리스트에서는 거의 눈에 띄지 않는데, 3단계 체크박스가 이를 디렉터리 수준에서 드러내 줍니다.
  • 모두 접기 / 모두 펼치기로 여러 디렉터리에 걸친 변경 세트도 쉽게 다룰 수 있습니다.

플랫 리스트는 그대로 유지되며 모든 행에 전체 경로가 계속 표시됩니다. 변경 세트가 작아서 그룹화가 오히려 클릭만 늘리는 경우에 적합합니다.

커밋 메시지 작성

파일을 스테이징했다면 Git 패널 하단의 텍스트 필드에 커밋 메시지를 입력하세요.

좋은 커밋 메시지는 히스토리를 읽기 쉽게 만들어 줍니다. 미래의 나 자신과 프로젝트의 다른 사람 모두에게 도움이 됩니다. 몇 가지 팁은 다음과 같습니다.

  • 명령형을 사용하세요 — "Added login form"이나 "Adding login form"이 아니라 "Add login form"처럼 작성합니다
  • 무엇이 왜 바뀌었는지 설명하세요 — "fix bug"보다 "Fix null check in user.ts"가 더 유용합니다
  • 첫 줄은 72자 이내로 유지하세요 — 대부분의 git 도구는 목록 뷰에서 더 긴 메시지를 잘라서 표시합니다
  • 필요하면 본문을 추가하세요 — 첫 줄 뒤에 Enter를 두 번 눌러 아래에 더 긴 설명을 작성합니다

명확한 커밋 메시지 예시:

  • Add email validation to signup form
  • Fix crash when user list is empty
  • Update API base URL for production

에이전트에게 작성 맡기기

커밋 요약란의 스파클 버튼은 diff를 설치된 AI CLI에 전달하고 커밋 메시지를 요청합니다.

  • 메시지를 작성할 에이전트를 직접 지정하거나, 설치된 에이전트 중 첫 번째를 1DevTool이 사용하도록 둘 수 있습니다. 목록에는 다른 에이전트와 함께 Kimi Code도 포함되어 있습니다. 설치된 에이전트가 많으면 메뉴가 창 크기에 맞춰지고 스크롤됩니다.
  • 스타일을 선택하세요: Conventional, Plain, Gitmoji.
  • 아직 스테이징된 항목이 없으면 작업 트리의 diff로 대신 동작하므로, 무엇을 스테이징할지 정하기 전에도 메시지를 받아볼 수 있습니다.

결과는 메시지 필드에 일반 편집 가능한 텍스트로 입력됩니다. 이는 초안일 뿐 커밋이 아닙니다.

커밋

메시지 필드 아래의 Commit 버튼을 클릭하세요. 스테이징된 변경 사항이 새 커밋으로 로컬 git 히스토리에 저장되고, 스테이징된 파일 섹션이 비워집니다.

이제 커밋이 브랜치 히스토리에 나타납니다. 커밋을 되돌려야 한다면 히스토리 뷰에서 해당 커밋을 마우스 오른쪽 버튼으로 클릭하고 Undo Commit을 선택하세요. 변경 내용이 사라지지 않고 unstaged 파일로 되돌아갑니다.

원격 저장소에 푸시

커밋은 변경 사항을 로컬에만 저장합니다. GitHub, GitLab 또는 다른 원격 저장소로 보내려면 다음과 같이 하세요.

  1. Git 패널 툴바의 Push 버튼(위쪽 화살표 아이콘)을 클릭합니다
  2. 브랜치가 이미 원격에 있다면 커밋이 즉시 푸시됩니다
  3. 원격에 아직 없는 새 브랜치라면 Publish Branch를 클릭하세요. 원격에 브랜치가 생성되고 커밋이 푸시됩니다

자격 증명을 요청받으면 직접 입력하거나 SSH 키 인증으로 전환할 수 있습니다. GitHub 계정을 연결해 자격 증명이 자동으로 처리되도록 하는 방법은 Git 계정을 참고하세요.

새 브랜치 푸시

변경 사항 풀

원격의 변경 사항을 가져오려면(예: 팀원이 무언가를 푸시한 경우):

  1. 툴바의 Pull 버튼(아래쪽 화살표 아이콘)을 클릭합니다
  2. 원격 변경 사항을 가져와 로컬 브랜치에 병합합니다

병합 충돌이 있으면 Git 패널이 충돌한 파일을 강조 표시합니다. 각 파일을 열어 충돌을 해결한 다음, 해결 내용을 스테이징하고 커밋하세요.

Git 추가를 위한 빠른 버튼

푸시가 끝나면 변경 사항이 원격에 반영되어 팀원과 공유되거나 풀 리퀘스트를 만들 준비가 됩니다. Git 패널에는 브랜치가 원격과 최신 상태라고 표시됩니다.