← 블로그로 돌아가기

GitKraken에서 GitSquid로 마이그레이션하는 방법: 단계별 가이드

guide migration

GitKraken에서 GitSquid로 마이그레이션하는 방법: 단계별 가이드

Git 클라이언트를 바꾸는 것은 번거로운 일입니다. 프로필, 통합, 테마, 키보드 단축키 등 잘 작동하는 환경이 있는데 처음부터 다시 설정하고 싶지 않을 겁니다. 이 가이드는 약 15분 안에 GitKraken 설정을 GitSquid에 복제하는 방법과, 가장 자주 사용하던 Git 작업에 대한 기능 매핑 표를 제공합니다.

고지: 이 글은 GitSquid 웹사이트에 게시되었습니다.

시작하기 전에

여기서 다루는 어떤 것도 여러분의 저장소를 건드리지 않습니다. GitKraken과 GitSquid는 모두 `.git` 폴더에 대해 읽기 전용입니다 — Git 명령을 호출할 뿐 데이터를 소유하지 않습니다. 두 앱을 동시에 설치해 같은 저장소를 가리키게 하고, 언제든 되돌아갈 수 있습니다.

깔끔하게 비교하고 싶다면 GitSquid를 설치해 일주일 사용한 뒤 GitKraken을 제거하세요. 워크플로우가 안정적인지 확인하기에 충분합니다.

1단계: GitSquid 설치 (2분)

다운로드 페이지에서 사용 중인 플랫폼용 빌드를 받으세요:

  • macOS — arm64 네이티브 (Rosetta로 Intel에서도 동작).
  • Windows — x64 네이티브 또는 ARM64 (Snapdragon X / Surface Pro X).
  • Linux — x64 또는 ARM64용 AppImage.

계정 생성 없음. 텔레메트리 동의 다이얼로그 없음. 앱을 열면 환영 화면이 표시됩니다.

2단계: 기존 저장소 연결 (2분)

환영 화면에서 "저장소 열기"를 클릭하고 GitKraken에서 사용하던 동일한 폴더를 선택하세요. 각 저장소는 GitKraken처럼 자체 탭으로 열립니다. Free 버전은 동시에 3탭, Pro는 무제한입니다.

최근 사용한 저장소는 환영 화면에 자동으로 나타납니다 — 5개 이상이면 검색도 가능합니다.

3단계: 프로필 재구성 (3분)

GitKraken에서 여러 Git 신원을 사용했다면 (회사 이메일, 개인 이메일, 오픈소스 신원), 설정 → 프로필에서 다시 만드세요:

  1. "프로필 만들기" 클릭.
  2. 이름 입력 (예: "회사" 또는 "Open source").
  3. Git name과 email을 GitKraken과 동일하게 설정.
  4. 커밋에 서명한다면 GPG 서명 필드에 GPG 키 ID 붙여넣기.
  5. 각 신원에 대해 반복.

Free 버전은 1개의 프로필을, Pro는 무제한을 지원합니다. GitSquid에서 프로필 전환은 타이틀바에서 한 번 클릭, GitKraken과 동일한 모델입니다.

4단계: Git 호스팅 제공자 연결 (3분)

설정 → 통합에서 각 호스팅 제공자를 연결하세요:

GitHub

  1. GitHub 옆의 "연결" 클릭.
  2. github.com/settings/tokens를 열어 fine-grained personal access token을 만들고 repo와 pull request 스코프 부여.
  3. GitSquid에 붙여넣기. 통합은 `/user`를 호출해 검증합니다.

GitLab

  1. GitLab 옆의 "연결" 클릭.
  2. gitlab.com/-/profile/personal_access_tokens를 열어 `api` 스코프의 personal access token 생성.
  3. GitSquid에 붙여넣기.

Bitbucket Cloud

  1. Bitbucket 옆의 "연결" 클릭.
  2. Bitbucket은 더 이상 app password를 사용하지 않습니다. id.atlassian.com/manage-profile/security/api-tokens에서 Atlassian API token 생성.
  3. Atlassian 이메일과 API 토큰 입력. GitSquid는 Bitbucket Cloud가 기대하는 형식인 email + token으로 HTTP basic 인증을 수행합니다.

연결 후에는 각 제공자의 pull request 목록 / 생성 / 리뷰, 이슈 관리, CI 체크 상태 확인을 모두 GitSquid 안에서 처리할 수 있습니다 — GitKraken과 동일한 워크플로우입니다.

Free는 1개의 통합을, Pro는 무제한을 지원합니다.

5단계: 테마 재현 (1분)

GitSquid는 기본적으로 6개의 테마를 제공합니다: Dark, Light, Midnight, Solarized Dark, Dracula, Nord. 설정 → 외관에서 선택하세요.

커스텀 GitKraken 테마를 사용했다면, GitSquid Pro는 설정 → 테마에서 자체 테마를 만들 수 있습니다: 각 색상 (background primary / secondary, accent, text, border)을 편집하고 저장하세요. GitKraken 형식의 자동 임포트는 없습니다.

6단계: 키보드 단축키 매핑 (2분)

GitSquid의 기본 단축키는 GitKraken과 비슷하지만 동일하지는 않습니다:

동작 GitKraken 기본값 GitSquid 기본값
커밋 검색Cmd/Ctrl+PCmd/Ctrl+F
새 브랜치Cmd/Ctrl+BCmd/Ctrl+N
커밋 (스테이징)Cmd/Ctrl+EnterCmd/Ctrl+Enter
터미널 토글없음Cmd/Ctrl+`
명령 로그 토글없음Cmd/Ctrl+Shift+L
키보드 단축키?F1

GitKraken의 근육 기억에 맞춰 단축키를 바꾸고 싶다면 설정 → 단축키 (Pro)로 이동하세요. 원하는 동작을 클릭하고 새 조합을 누른 뒤 저장. 개별 또는 전체 단축키를 한 번에 초기화할 수 있습니다.

기능 매핑

GitKraken 기능 GitSquid 대응
커밋 그래프동일, virtual scrolling이 적용된 canvas 렌더링
스테이징 (파일 / hunk / 줄)동일, 추가로 드래그 앤 드롭과 폴더 단위 작업
diff 뷰어 (unified / split / blame)동일, 풀 신택스 하이라이트의 CodeMirror 기반
병합 충돌 에디터코드 에디터가 내장된 동일한 3-way 에디터
인터랙티브 rebase동일, 커밋별 액션이 있는 드래그 앤 드롭 재정렬
Cherry-pick / revert / reset동일, 다중 커밋 cherry-pick 포함
스태시 관리동일, list / save / apply / pop / drop / clear all
태그 관리동일, 생성 / 삭제 / 원격으로 push
Worktree동일, 생성 / 잠금 / 잠금 해제 / 삭제 / 탭으로 열기
Submodule동일, list / init / update
Gitflow동일, init + feature / release / hotfix start & finish
Git LFS동일, track patterns / pull / push / 상태 패널
reflog 뷰어reflog에서의 checkout 포함, 동일
GPG 서명동일, 프로필별 설정
Pull request / 이슈GitHub / GitLab / Bitbucket에서 동일한 흐름
AI 커밋 메시지지원 (Claude Code, Anthropic, OpenAI, 커스텀)
AI explain신규 — commit / hunk / 파일 우클릭으로 스트리밍 설명
AI PR 설명신규 — PR 생성 다이얼로그의 "Generate with AI"
충돌 예측기신규 — merge / rebase / cherry-pick 전 충돌 미리보기
프리커밋 시크릿 스캔신규 — AWS / GitHub / OpenAI 키, JWT 등을 차단
Branch intent신규 — git notes를 통해 브랜치에 첨부되는 markdown 계획
모노레포 스코프신규 — npm / pnpm / Cargo / Nx 워크스페이스 자동 감지
파일 타임라인 스크러버신규 — 파일 히스토리 위에서 슬라이더 드래그
팀 활동 타임라인신규 — 작성자 × 주별 히트맵
Jira 통합GitSquid에 없음
Azure DevOps 통합GitSquid에 없음
GitLens (VS Code)해당 없음 — GitSquid는 데스크톱 클라이언트 전용
클라우드 프로필 / 설정 동기화GitSquid에 없음 — 모든 것이 로컬 유지

잃게 되는 것

기대치를 정리하기 위해, GitSquid에 대응이 없는 GitKraken 기능들:

  • Jira / Azure DevOps 통합. 팀이 이에 의존한다면 GitSquid는 이 측면에서 GitKraken을 대체하지 못합니다. 공개 백로그에서 추적합니다.
  • 클라우드 동기화 설정. GitKraken은 Atlassian 계정을 통해 머신 간 프로필과 설정을 동기화합니다. GitSquid는 모든 것을 로컬에 보관합니다. 여러 머신에서 작업한다면 현재로서는 각 머신에서 3~6단계를 다시 수행해야 합니다.
  • 팀 관리 대시보드. GitKraken에는 조직 수준의 관리 기능이 있습니다. GitSquid는 개별 시트로 라이선스됩니다.

이 중 어떤 것이 워크플로우에 필수적이라면 GitSquid는 깔끔한 마이그레이션 대상이 아닙니다.

얻게 되는 것

  • 절반 가격. 49 EUR/년 vs 96 $/년.
  • 계정 불필요. 실행 시 로그인 화면 없음.
  • 텔레메트리 없음. 머신에서 어떤 것도 외부로 나가지 않음.
  • Linux 지원. 머신을 옮겨도 Linux x64 및 ARM64용 네이티브 바이너리.
  • 더 빠른 콜드 스타트와 더 낮은 RAM. Tauri / Rust 대 Electron.
  • 현대적 기능. 충돌 예측기, 시크릿 스캔, 모노레포 스코프, 파일 타임라인, 팀 활동, AI explain — 모두 GitKraken에는 없습니다.
  • 활발한 릴리스 주기. 1~2주마다 업데이트와 공개 changelog.

되돌리기로 결정한다면

두 앱 모두 `.git` 폴더에 대해 읽기 전용이므로 — 되돌리려면 GitKraken을 다시 실행하기만 하면 됩니다. 데이터 락인 없음. 49 EUR/년은 연간 결제이므로 어느 갱신 주기에서든 결제를 중단할 수 있습니다.

위 마이그레이션은 처음에 약 15분 소요됩니다. 금요일 오후에 진행하고 다음 한 주 GitSquid를 사용해 보세요. 한 주가 끝날 즈음, 절감과 현대적 기능이 자신의 워크플로우에 맞는 트레이드오프를 정당화하는지 알 수 있을 것입니다.

GitSquid Free 다운로드로 시작하세요.