lazygit
- 추천0
- GitHub 별84K
- 버전 관리라이선스MIT
터미널에서 git을 키 하나로 다루는 간단한 TUI. 라인 단위 스테이징, 인터랙티브 리베이스, 체리픽, 바이섹트를 지원해요
요약
터미널에서 git을 키 하나로 다루는 간단한 TUI. 라인 단위 스테이징, 인터랙티브 리베이스, 체리픽, 바이섹트를 지원해요
설명

lazygit은 git 명령을 위한 간단한 터미널 UI입니다.
데모 영상: 커밋하고 푸시하기
후원
이 프로젝트의 유지보수는 모든 기여자와 후원자 덕분에 가능합니다. 후원하고 싶다면 여기를 눌러 주세요. 💙
특별히 감사드립니다: Subble — 저(Jesse)는 회사가 쓰지 않거나 과하게 구매한 SaaS 라이선스를 찾아 시간과 비용을 아껴 주는 Subble을 공동 창업했습니다. 한번 살펴보세요!
엘리베이터 피치
불평 좀 하겠습니다. 다들 들어 봤을 겁니다. git은 강력합니다. 하지만 뭐든 이렇게 어렵다면 그 힘이 무슨 소용일까요? 인터랙티브 리베이스를 하려면 에디터에서 빌어먹을 TODO 파일을 고쳐야 한다고요? 장난합니까? 파일의 일부만 스테이징하려면 명령줄 프로그램으로 헝크를 하나씩 넘겨 봐야 하고, 더 쪼갤 수 없는 헝크에 스테이징하기 싫은 코드가 섞여 있으면 난해한 패치 파일을 손으로 고쳐야 한다고요? 장난하는 겁니까?! 브랜치를 옮길 때 변경 사항을 stash 하라는 요청을 받고, 옮기고 stash를 풀어 보니 충돌이 전혀 없었다는 걸 깨닫기도 합니다. 그냥 바로 체크아웃해도 됐을 일이었던 거죠. 말도 안 돼요!
저처럼 평범한 사람이라서 git이 강력하다는 얘기에 지쳤다면, 일상에서는 그 힘이 그저 강력한 골칫거리일 뿐이니까요, lazygit이 맞을지도 모릅니다.
목차
- 후원
- 엘리베이터 피치
- 기능
- 튜토리얼
- 설치
- 사용법
- 설정
- 기여하기
- 후원하기
- 자주 묻는 질문
- 홍보
- 대안
lazygit은 제 정규직은 아니지만 꽤 큰 파트타임 일입니다. 프로젝트를 응원하고 싶다면 후원을 고려해 주세요.
기능
헝크 또는 개별 줄 스테이징
변경된 파일에서 0을 누르면 메인 뷰에서 그 파일의 diff에 포커스가 갑니다. 처음에는 헝크 전체가 선택되어 있어서 스페이스 키를 누르면 그 헝크를 스테이징하고 다음 헝크로 넘어갑니다. 헝크의 일부만 원하면 a를 눌러 줄 단위 선택을 하고, v로 줄 범위를 선택합니다. 스테이징한 내용은 아래 패널에 나타납니다. 탭 키로 두 패널 사이를 오가고, 아래 패널에서 스페이스 키를 누르면 스테이징이 취소됩니다. c를 누르면 diff를 벗어나지 않고 바로 커밋합니다.
데모 영상: 헝크 · 줄 스테이징
인터랙티브 리베이스
i를 눌러 인터랙티브 리베이스를 시작합니다. 그런 다음 TODO 커밋을 squash(s), fixup(f), drop(d), edit(e), 위로 이동(ctrl+k), 아래로 이동(ctrl+j) 할 수 있고, 끝나면 m으로 리베이스 옵션 메뉴를 열어 continue를 선택해 리베이스를 이어 갑니다.
리베이스를 따로 시작하지 않고도 이런 동작을 한 번만 수행할 수 있습니다(예: 커밋에서 s를 눌러 squash).
이 데모에서는 shift+아래 화살표로 커밋 범위를 선택해 옮기고 fixup 하는 모습도 보여 줍니다.
데모 영상: 인터랙티브 리베이스
체리픽
커밋에서 shift+c를 누르면 복사하고, shift+v를 누르면 붙여 넣습니다(체리픽).
데모 영상: 체리픽
바이섹트
커밋 뷰에서 b를 누르면 커밋을 good/bad로 표시해 git bisect를 시작합니다.
데모 영상: 바이섹트
작업 트리 날려 버리기
git status에 나타나는 모든 것(더러운 서브모듈 포함)을 kidpix 스타일로 말끔히 없애고 싶을 때는 shift+d로 리셋 옵션 메뉴를 열고 'nuke' 옵션을 선택합니다.
데모 영상: 작업 트리 날려 버리기
오래된 커밋 수정하기
아무 커밋에서나 shift+a를 누르면 현재 스테이징한 변경 사항으로 그 커밋을 수정(amend)합니다(백그라운드에서 인터랙티브 리베이스가 실행됩니다).
데모 영상: 오래된 커밋 수정
필터
/로 뷰를 필터링할 수 있습니다. 여기서는 브랜치 뷰를 걸러 낸 뒤 enter를 눌러 그 브랜치의 커밋을 봅니다.
데모 영상: 필터
커스텀 명령 실행
lazygit에는 매우 유연한 커스텀 명령 시스템이 있습니다. 이 예시는 내장 브랜치 체크아웃 동작을 흉내 내는 커스텀 명령을 정의한 모습입니다.
데모 영상: 커스텀 명령
워크트리
워크트리를 만들면 stash를 하거나 WIP 커밋을 만들 필요 없이 여러 브랜치를 동시에 진행할 수 있습니다. 브랜치 뷰에서 w를 누르면 선택한 브랜치로 워크트리를 만들고 그쪽으로 전환합니다.
데모 영상: 워크트리
리베이스 마법 (커스텀 패치)
오래된 커밋에서 커스텀 패치를 만든 뒤, 그 패치를 커밋에서 제거하거나, 새 커밋으로 떼어 내거나, 인덱스에 거꾸로 적용하는 등의 일을 할 수 있습니다.
이 예시에서는 오래된 커밋에 따로 커밋해야 할 변경이 섞여 있습니다. 커밋에서 0을 눌러 diff에 포커스를 맞추고, 옮기고 싶은 헝크에서 스페이스 키를 누르면 커스텀 패치에 추가됩니다. ctrl+p로 커스텀 패치 옵션을 열어 패치를 새 커밋으로 옮기는 것을 고릅니다.
자세한 내용은 리베이스 마법 유튜브 튜토리얼을 보세요.
데모 영상: 커스텀 패치로 커밋 나누기
오래된 커밋에서 헝크 하나만 지우려는 거라면 커스텀 패치가 필요 없습니다. 커밋의 diff에서 헝크를 선택하고 d를 누르세요. lazygit이 백그라운드에서 인터랙티브 리베이스를 실행해 그 헝크가 빠진 커밋으로 다시 씁니다.
데모 영상: 커밋에서 헝크 지우기
표시한 기준 커밋에서 리베이스
develop 브랜치에서 갈라져 나온 기능 브랜치에 있는데, 생각해 보니 master 브랜치에서 갈라지는 게 낫겠다고 판단했다고 해 봅시다. 기능 브랜치의 커밋만 리베이스할 방법이 필요합니다. 이 데모에서는 develop 브랜치의 마지막 커밋을 확인하고, shift+b로 그 커밋을 기준 커밋으로 표시한 다음, master 브랜치에서 r을 눌러 거기로 리베이스합니다. 그러면 기능 브랜치의 커밋만 넘어갑니다. 그 뒤 shift+p로 변경 사항을 푸시합니다.
데모 영상: 기준 커밋에서 리베이스
되돌리기 (Undo)
z를 눌러 마지막 동작을 되돌리고 shift+z로 다시 실행할 수 있습니다. 여기서는 커밋 몇 개를 drop 한 뒤 그 동작을 되돌립니다.
Undo는 커밋과 브랜치에 한정된 reflog를 사용하므로 작업 트리나 stash의 변경은 되돌릴 수 없습니다.
데모 영상: 되돌리기
커밋 그래프
창을 키워서 볼 때(+와 _로 화면 모드를 순환) 커밋 그래프가 나타납니다. 색은 커밋 작성자에 대응하고, 그래프를 따라 내려가면 선택한 커밋의 부모 커밋이 강조됩니다.
데모 영상: 커밋 그래프
두 커밋 비교
커밋(또는 브랜치/ref)에서 shift+w를 누르면 메뉴가 열리고, 그 커밋을 표시해 두면 이후 선택하는 다른 커밋과 diff를 비교합니다. 두 번째 커밋을 고르면 메인 뷰에 diff가 나타나고, 엔터 키를 누르면 diff의 파일 목록이 보입니다. shift+w를 다시 누르면 diff 메뉴가 열려 diff 방향 뒤집기, diff 모드 끝내기 같은 옵션을 볼 수 있습니다. Esc 키로도 diff 모드를 끝낼 수 있습니다.
데모 영상: 두 커밋 비교
GitHub 풀 리퀘스트 보기
브랜치 패널에서 lazygit은 브랜치 이름 옆에 GitHub 아이콘을 보여 주어 어떤 브랜치에 GitHub 풀 리퀘스트가 연결되어 있는지 알려 줍니다. 아이콘 색은 PR 상태(열림, 병합됨 등)를 나타냅니다. PR이 있는 브랜치에서는 shift-G를 눌러 브라우저로 PR을 열 수 있습니다. github.com에서는 별도 설정이 필요 없지만 gh 도구가 설치되어 있어야 하고, lazygit이 GitHub에 접근하도록 gh auth login을 한 번 해야 합니다. GitHub Enterprise는 gh auth login --hostname <호스트>도 실행하고, 그 호스트의 services 항목을 github 제공자로 추가하세요.
튜토리얼
설치
위 패키지의 대부분은 제3자가 관리하므로, 직접 검토해 보고 관리자가 지역 스포츠 경기를 보러 다니고 바비큐 모금 행사로 동네에 보답하는 믿음직한 사람인지 확인하세요.
바이너리 릴리스
Windows, Mac OS(10.12 이상), Linux에서는 여기에서 바이너리 릴리스를 내려받을 수 있습니다.
개발 컨테이너 기능
GitHub Codespaces 같은 곳에서 lazygit을 쓰고 싶다면, 위의 바이너리 릴리스를 기반으로 한 제3자 개발 컨테이너 기능이 있습니다.
Homebrew
Linux에서도 동작합니다.
brew install lazygit
MacPorts
GitHub 릴리스로 빌드한 최신 버전입니다.
sudo port install lazygit
Void Linux
Void Linux용 패키지는 배포판 저장소에 있으며 업스트림 최신 릴리스를 따라갑니다.
sudo xbps-install -S lazygit
Scoop (Windows)
scoop으로 lazygit을 설치할 수 있습니다. extras 버킷에 있습니다.
# extras 버킷 추가
scoop bucket add extras
# lazygit 설치
scoop install lazygit
gah (Linux, Mac OS)
gah로 lazygit을 설치할 수 있습니다.
gah install lazygit
Arch Linux
Arch Linux용 패키지는 pacman과 AUR(Arch User Repository)로 제공됩니다.
패키지는 두 가지입니다. 최신 릴리스로 빌드한 안정 버전과, 가장 최근 커밋에서 빌드하는 git 버전입니다.
- 안정 버전:
sudo pacman -S lazygit - 개발 버전: lazygit-git
AUR 내용을 설치하는 방법은 Arch Wiki에 있습니다.
Fedora / Amazon Linux 2023 / CentOS Stream
Fedora, Amazon Linux 2023, CentOS Stream용 패키지는 Copr(Cool Other Package Repo)로 제공됩니다.
sudo dnf copr enable dejan/lazygit
sudo dnf install lazygit
이 패키지는 https://codeberg.org/dejan/rpm-lazygit 에 있는 RPM spec 파일로 빌드됩니다.
Fedora 41 이하와 그 밖의 Fedora 파생판용 RPM은 최신 COPR 빌드에서 받을 수 있는 SRPM(소스 RPM) 파일로 빌드할 수 있습니다.
Fedora / RHEL 파생판 (Terra)
Fedora와 RHEL 파생판용 패키지는 Terra 저장소에서도 받을 수 있습니다.
sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terra$releasever' terra-release
sudo dnf install lazygit
(Atomic/EL 설치 안내는 Terra의 README에 있습니다.)
Terra에는 docs 폴더 내용을 담은 lazygit-doc도 있습니다.
Solus Linux
sudo eopkg install lazygit
Debian과 Ubuntu
Debian 13 "Trixie", Sid 이후, 또는 Ubuntu 25.10 "Questing Quokka" 이후:
sudo apt install lazygit
Debian 12 "Bookworm", Ubuntu 25.04 "Plucky Puffin" 이하:
LAZYGIT_VERSION=$(curl -s "https://api.github.com/repos/jesseduffield/lazygit/releases/latest" | \grep -Po '"tag_name": *"v\K[^"]*')
LAZYGIT_ARCH=$(uname -m | sed -e 's/aarch64/arm64/')
curl -Lo lazygit.tar.gz "https://github.com/jesseduffield/lazygit/releases/download/v${LAZYGIT_VERSION}/lazygit_${LAZYGIT_VERSION}_Linux_${LAZYGIT_ARCH}.tar.gz"
tar xf lazygit.tar.gz lazygit
sudo install lazygit -D -t /usr/local/bin/
lazygit이 제대로 설치됐는지 확인합니다.
lazygit --version
Funtoo Linux
Funtoo Linux는 dev-kit에 자동 생성된 lazygit 패키지가 있습니다.
sudo emerge dev-vcs/lazygit
Gentoo Linux
lazygit은 (아직) Gentoo 메인 portage에는 없지만, GURU 오버레이에 ebuild가 있습니다.
오버레이를 시스템에 추가한 뒤 평소처럼 lazygit을 설치하면 됩니다.
sudo eselect repository enable guru
sudo emaint sync -r guru
sudo emerge dev-vcs/lazygit
openSUSE
lazygit 패키지는 현재 devel:languages:go/lazygit에서 빌드됩니다.
openSUSE Tumbleweed에 설치하려면:
sudo zypper ar https://download.opensuse.org/repositories/devel:/languages:/go/openSUSE_Factory/devel:languages:go.repo
sudo zypper ref && sudo zypper in lazygit
openSUSE Leap에 설치하려면:
source /etc/os-release
sudo zypper ar https://download.opensuse.org/repositories/devel:/languages:/go/$VERSION_ID/devel:languages:go.repo
sudo zypper ref && sudo zypper in lazygit
NixOS
nixpkgs의 lazygit 쓰기
NixOS에서 lazygit은 nix로 패키징되어 nixpkgs로 배포됩니다. 설치하지 않고 써 볼 수도 있습니다.
nix-shell -p lazygit
# 또는 flakes를 켠 경우
nix run nixpkgs#lazygit
또는 configuration.nix의 environment.systemPackages 옵션에 lazygit을 추가할 수 있습니다. 자세한 내용은 NixOS 검색 페이지에 있습니다.
공식 lazygit flake 쓰기
이 저장소에는 최신 개발 버전과 추가 개발 도구를 제공하는 nix flake가 들어 있습니다.
저장소에서 바로 lazygit 실행:
nix run github:jesseduffield/lazygit
# 또는 로컬 클론에서
nix run .
소스에서 lazygit 빌드:
nix build github:jesseduffield/lazygit
# 또는 로컬 클론에서
nix build .
개발 환경: 기여자를 위해 flake는 Go 툴체인, 개발 도구, 의존성을 갖춘 개발 셸을 제공합니다.
nix develop github:jesseduffield/lazygit
# 또는 로컬 클론에서
nix develop
개발 셸에는 다음이 들어 있습니다.
- Go 툴체인
- git과 make
- 개발에 맞는 환경 변수
다른 flake에서 쓰기: flake는 다른 flake 기반 프로젝트에 쉽게 통합할 수 있는 오버레이도 제공합니다.
{
inputs.lazygit.url = "github:jesseduffield/lazygit";
outputs = { self, nixpkgs, lazygit }: {
# 오버레이 사용
nixpkgs.overlays = [ lazygit.overlays.default ];
};
}
Flox
lazygit은 Flox 환경에 다음처럼 설치할 수 있습니다.
flox install lazygit
Flox에 대한 자세한 내용은 Flox 웹사이트에 있습니다.
FreeBSD
pkg install lazygit
Termux
apt install lazygit
Conda
여러 플랫폼용 릴리스 버전이 있습니다. conda-forge 페이지를 보세요.
conda install -c conda-forge lazygit
Go
go install github.com/jesseduffield/lazygit@latest
참고:
lazygit을 찾을 수 없다거나 정의되지 않았다는 오류가 나면 ~/go/bin(macOS/Linux) 또는 %HOME%\go\bin(Windows)을 $PATH에 추가해야 할 수 있습니다. Go 자체 바이너리용인 C:\Go\bin과 헷갈리지 마세요. 그곳은 lazygit 같은 앱이 아니라 Go의 바이너리용입니다.
Chocolatey (Windows)
Chocolatey로 lazygit을 설치할 수 있습니다.
choco install lazygit
Winget (Windows 10 1709 이상)
Windows 터미널에서 winget 명령으로 lazygit을 설치할 수 있습니다.
winget install -e --id=JesseDuffield.lazygit
수동 설치
Go를 설치해야 합니다.
git clone https://github.com/jesseduffield/lazygit.git
cd lazygit
go install
go run main.go로 컴파일과 실행을 한 번에 할 수도 있습니다(말장난은 물론 의도한 겁니다).
사용법
git 저장소 안의 터미널에서 lazygit을 호출합니다.
$ lazygit
원한다면 echo "alias lg='lazygit'" >> ~/.zshrc(또는 쓰는 rc 파일)로 별칭을 추가할 수도 있습니다.
키 바인딩
키 바인딩 목록은 여기에서 볼 수 있습니다.
종료할 때 디렉터리 바꾸기
lazygit 안에서 저장소를 바꿨고 lazygit을 끝낼 때 셸도 그 저장소 디렉터리로 이동하길 원한다면, ~/.zshrc(또는 다른 rc 파일)에 다음을 추가하세요.
lg()
{
export LAZYGIT_NEW_DIR_FILE=~/.lazygit/newdir
lazygit "$@"
if [ -f $LAZYGIT_NEW_DIR_FILE ]; then
cd "$(cat $LAZYGIT_NEW_DIR_FILE)"
rm -f $LAZYGIT_NEW_DIR_FILE > /dev/null
fi
}
그런 다음 source ~/.zshrc를 실행하세요. 이제부터 lg를 호출하고 끝내면 lazygit 안에서 있던 디렉터리로 이동합니다. 이 동작을 건너뛰려면 q 대신 shift+Q로 끝내세요.
실행 취소/다시 실행
문서를 보세요.
설정
설정 문서를 확인하세요.
커스텀 diff 렌더러
문서를 보세요.
커스텀 명령
lazygit에 없는 기능이 있다면 커스텀 명령으로 직접 구현할 수 있을 가능성이 높습니다!
문서를 보세요.
Git flow 지원
lazygit은 Gitflow(또는 git-flow-next)가 설치되어 있다면 이를 지원합니다. Gitflow 모델이 어떻게 동작하는지는 Vincent Driessen의 원 글을 보세요. lazygit 안에서 Gitflow 옵션을 보려면 브랜치 뷰에서 i를 누르세요.
기여하기
여러분의 의견을 환영합니다! 기여 가이드를 확인해 주세요. 저장소에서 다루기 적합하지 않은 기여자 논의는 디스코드 채널에 참여하세요.
lazygit에 작은 기능을 만드는 과정을 보여 주는 영상이 있으니, 어디서 시작할지 감을 잡고 싶다면 보세요.
로컬에서 디버깅하기
한 터미널 탭에서 lazygit --debug를, 다른 탭에서 lazygit --logs를 실행하면 프로그램과 로그 출력을 나란히 볼 수 있습니다.
후원하기
lazygit 개발을 돕고 싶다면 저를 후원해 주세요(GitHub가 12개월 동안 모든 후원금을 같은 금액만큼 매칭해 줍니다).
자주 묻는 질문
커밋 색은 무엇을 뜻하나요?
- 초록: 그 커밋이 master 브랜치에 포함되어 있음
- 노랑: 그 커밋이 master 브랜치에 포함되어 있지 않음
- 빨강: 그 커밋이 업스트림 브랜치에 아직 푸시되지 않음
홍보
제(Jesse)가 개발 쪽에서 무엇을 하고 있는지 궁금하다면 트위터를 팔로하거나 블로그를 보세요.
대안
lazygit이 요구 사항에 딱 맞지 않는다면 다음이 더 맞을 수 있습니다.
라이선스
MIT 라이선스입니다. 저장소: jesseduffield/lazygit
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0