GitLinq / GETTING STARTED
0.6.0 사용 안내
기존 사용자를 위한 저장소 검색·정렬·그룹 제안, 일상 Git 작업과 화면·언어 설정, 브라우저 연결을 안내합니다.
기능 안내 보기 →배포 상태와 Windows x64 요구사항
Windows 10/11 x64와 Microsoft Edge WebView2 Evergreen Runtime이 필요합니다. Git 2.30 이상은 기존 설치를 선택하거나 앱 설정에서 준비할 수 있습니다.
Git 2.30 이상
Git 설치 폴더 전체를 유지하세요. git.exe 하나만 복사한 구성은 사용할 수 없습니다. Git for Windows에서는 cmd\git.exe를 권장합니다.
WebView2 Evergreen Runtime
앱 실행 전에 설치되어 있어야 합니다. Evergreen Standalone Installer를 쓰면 x64를 선택하세요.
Microsoft 공식 다운로드설치본 · 안내 보류
GitLinq-0.6.0-windows-x64-setup.exe의 다운로드·실행 안내를 일시 보류합니다. 설치본은 현재 사용자의 %LOCALAPPDATA%\Programs\GitLinq 경로를 사용하는 구성입니다.
WebView2가 없으면 설치가 중단됩니다. 설치 프로그램은 Git·WebView2를 자동 설치하거나 PATH를 변경하지 않습니다. 실행 중인 GitLinq는 설치 전에 닫으세요.
GitLinq Connector
연결기는 설치본에 함께 포함되며 Node.js가 필요하지 않습니다. 설치 화면에서 브라우저 연결 허용과 Windows 로그인 시 백그라운드 실행을 각각 선택할 수 있습니다. 해제해도 데스크톱에서 사용하는 공통 Git 엔진은 설치됩니다.
브라우저에서 사용하려면 gitlinq.devslab.kr에서 이 컴퓨터 연결을 누르세요. 열린 GitLinq 승인 창에서 이 브라우저와 사용할 저장소를 확인합니다. 브라우저가 요청하면 로컬 네트워크 연결을 허용하세요. 이후 접속에서는 저장된 연결을 확인합니다.
커넥터는 %LOCALAPPDATA%\Programs\GitLinqConnector에 현재 사용자 전용으로 보관됩니다. 업데이트 중 실행 중인 Git 작업이 있으면 작업을 끊지 않고 설치를 거절합니다. 작업 결과를 확인하고 다운로드·설치 안내가 재개된 뒤에만 다시 설치를 진행하세요.
이 PC에 등록된 브라우저의 접근 권한을 모두 취소하려면 시작 메뉴에서 GitLinq Disconnect Browsers를 실행하세요. 브라우저 등록과 기존 연결 코드가 폐기됩니다. 진행 중인 Git 프로세스를 강제로 종료하지 않으며, 다시 연결하려면 웹에서 이 컴퓨터 연결을 누르고 새로 접근을 승인하세요. 웹의 연결 해제 버튼은 해당 화면과 브라우저의 로컬 등록만 지웁니다.
무설치본 · 안내 보류
Windows 배포 확인 중으로 GitLinq-0.6.0-windows-x64-portable.zip의 다운로드·실행 안내도 일시 보류합니다. 무설치본은 같은 계정의 설치본과 설정·저장된 작업을 공유하는 구성입니다.
배포 폴더의 GitLinq.exe, GitLinqConnector.exe, connector-manifest.json, 사용안내.html, THIRD-PARTY-NOTICES.txt, payload-manifest.json을 함께 유지하세요. 파일 일부만 옮기지 마세요.
브라우저에서 로컬 Git 사용하기
웹 사용에도 같은 컴퓨터에 설치된 GitLinq Connector와 저장소 접근 승인이 필요합니다. 웹 앱(PWA)을 설치해도 Connector가 설치되지는 않습니다. 0.6.0 신규 다운로드·설치 안내는 현재 보류 중입니다. Node.js는 필요하지 않으며 Linux·macOS 커넥터의 Git 작업은 아직 지원하지 않습니다.
- 기존에 설치된 Windows Connector가 있는 경우 아래 연결 흐름을 사용할 수 있습니다. 새 설치가 필요하다면 다운로드 안내 보류 상태를 확인하세요.
- gitlinq.devslab.kr에서 이 컴퓨터 연결을 누르세요.
- 열린 GitLinq 승인 창에서 브라우저와 저장소를 확인하고, 브라우저가 요청하면 로컬 네트워크 연결을 허용하세요.
앱이 열리지 않으면 기존 Connector의 실행 상태를 확인하세요. 보조 방법으로 시작 메뉴의 GitLinq Connector에서 표시한 일회용 코드를 웹의 연결 코드로 연결에 입력할 수 있습니다. 코드는 다른 사람에게 공유하지 마세요.
같은 컴퓨터의 앱과 웹
승인한 저장소의 이름·메모·그룹·즐겨찾기는 앱과 웹이 같은 정보를 사용합니다. 웹에는 이 브라우저에 허용한 저장소만 표시됩니다. 내용이 다르거나 저장 전 변경이 남아 있으면 짧은 비교를 확인하고 공통 정보·현재 변경·항목별 선택 중 사용할 정보를 결정하세요. 저장소마다 진행 중인 작업은 해당 화면에서 이어갑니다.
코드는 일회용이며 다른 사람에게 공유하지 마세요. 웹의 연결 해제는 해당 브라우저의 로컬 등록을 지웁니다. 이 PC에 등록된 모든 브라우저의 접근 권한을 취소하려면 시작 메뉴의 GitLinq Disconnect Browsers를 실행하세요.
irm·curl·npm·npx·winget·Chocolatey 설치 경로는 준비 또는 등록 중입니다. 0.6.0 설치 파일과 무설치 ZIP의 다운로드·설치 안내도 일시 보류합니다.
폴더 검색으로 목록을 만들고 필요한 저장소를 여세요
Git 폴더 추가
Git 저장소 폴더를 직접 선택하면 저장소를 확인해 엽니다. 여러 프로젝트가 있는 상위 폴더를 선택하면 하위 Git 저장소 후보를 검색합니다.
검색 결과를 목록에 추가
검색 진행과 결과 메시지를 확인하세요. 검색 중에는 취소할 수 있으며, 결과 반영 전에 취소하면 일부만 추가하지 않습니다. 검색 결과는 목록에 추가되며 여러 탭을 자동으로 열지 않습니다. 접근할 수 없는 폴더나 검색 한도는 결과에 표시됩니다.
저장소별 탭에서 작업
목록에서 필요한 저장소를 열고 탭으로 전환하세요. 탭마다 선택한 저장소와 작업 상태를 유지합니다. 다른 저장소의 작업을 확인하면서 원래 탭의 진행 상황을 다시 볼 수 있습니다.
검색·필터·정렬과 자동 그룹 제안
이름·폴더 경로·메모·그룹을 검색하고, 종류·즐겨찾기·그룹 조건으로 목록을 좁힙니다. 카드 보기와 목록 보기를 바꿀 수 있으며, 목록의 열 제목을 누르면 해당 열로 정렬합니다. 다음 페이지를 누르지 않고 계속 스크롤할 수 있으며, 화면 밖으로 이동한 항목의 선택도 유지합니다.
자동 그룹 제안은 비슷한 저장소 이름과 폴더를 바탕으로 제안합니다. 미리보기에서 그룹과 포함할 저장소를 확인한 뒤 적용하세요. 기존 그룹 지정은 유지합니다.
폴더 검색은 저장소 후보를 찾는 단계입니다. 실제 Git 작업은 저장소를 열고 상태를 다시 확인한 뒤 시작합니다. 같은 저장소와 연결된 worktree처럼 Git 데이터를 공유하는 작업은 필요한 경우 순서대로 처리하며, 상태가 바뀐 검토는 다시 확인해야 합니다.
변경을 검토하고 작업별로 실행하세요
저장소 탭을 열면 내 변경, 이력, 서버와 동기화에서 할 일을 고릅니다. 추가 기능은 작업 도구나 저장소 메뉴에서 엽니다.
- Stage·Unstage와 커밋: 변경 파일과 diff를 확인하고 포함할 변경을 선택합니다. 설명과 승인 영역에서 확인한 뒤 커밋하면 내 PC 기록에 저장됩니다. 변경이 없으면 파일 다시 확인을 사용하세요. 작성 중인 설명과 빈 폴더 유지 선택은 새로고침 후에도 이어집니다. 서버 공유는 별도 Push 작업입니다.
- Fetch·Pull·Push: 서버 대상과 받을 변경 또는 보낼 커밋을 먼저 확인합니다. 작업 폴더에 영향을 주는 변경과 서버 반영은 각 화면의 확인 절차를 따릅니다.
- 브랜치와 로그: 브랜치 목록과 선택한 커밋의 파일·diff를 확인하고, 화면에서 허용하는 브랜치 생성·전환·이름 변경 등의 작업을 검토합니다.
- 중단한 작업: 작업이 충돌이나 확인 필요 상태에서 멈추면 해당 화면의 결과 확인·계속·취소 안내를 사용합니다. 저장소 상태와 지원 조건에 따라 일부 작업은 차단됩니다.
탭 전환, 취소, 종료를 구분하세요
탭을 전환해도 시작한 작업은 해당 저장소에 연결됩니다. 탭 닫기와 앱 종료 시 진행 중인 작업이 있으면 앱이 표시하는 확인 절차를 따르세요. 취소 요청은 이미 완료된 커밋이나 서버 반영을 되돌리는 명령이 아닙니다.
연결이 끊겼거나 결과를 확정하지 못했다면 같은 작업을 새로 실행하기 전에 결과 확인 또는 진행 중인 작업 다시 확인 안내를 사용하세요. 재시작 후에도 같은 저장소를 열어 저장된 작업과 복구 화면부터 확인합니다. 결과가 불명확하면 성공으로 간주하지 마세요.
이전 취소 작업이 남아 있을 때
확인할 작업이나 저장된 취소 작업 화면에서 이전 기록을 엽니다. 서버 반영 여부 확인은 재전송과 다릅니다. 재전송은 앱이 그 행동을 명시적으로 제공하고 대상과 결과를 다시 확인한 경우에만 진행하세요. 이전 기록의 서버 취소와 내 PC 작업 폴더 업데이트도 별도 작업입니다.
일반·작업 공간·Git·연결로 나눠 찾으세요
설정 메뉴 또는 Ctrl+,로 환경 설정 창을 엽니다. 일반에서는 표시 언어·테마·안내·창 닫기 동작과 자동 업데이트를, 작업 공간에서는 대화·Git 작업 영역과 저장된 초안을 확인합니다.
일반 → 창 닫기 동작에서 종료 또는 트레이에서 계속 실행을 선택합니다. 트레이에서는 창만 숨기고 작업과 초안을 유지합니다. 트레이 메뉴의 종료는 저장 절차를 거쳐 앱을 종료합니다.
Git → Git 경로에서 자동 인식하거나 전체 Git 설치의 실행 파일을 지정합니다. 저장한 경로는 앱을 다시 실행하면 적용됩니다. Git → Git 준비·업데이트에서는 지원되는 공식 MinGit ZIP을 다운로드하거나 가져올 수 있습니다.
연결은 앱 업데이트와 Git 다운로드의 프록시·배포 연결을 설정합니다. 저장소 접속은 해당 저장소의 Git 연결 설정을 사용합니다.
GitLinq 앱 업데이트
업데이트 기능은 다운로드와 설치 전 확인 절차를 제공합니다. 현재 0.6.0 설치·업데이트 안내는 보류 중이며, 이미 받은 파일도 확인 전까지 설치를 보류해 주세요. 기능상 확인 창의 설치하고 다시 시작을 선택하면 설정과 모든 저장소의 초안을 저장한 뒤 앱을 종료합니다. 진행 중인 작업이 있거나 저장·설치 준비를 확인하지 못하면 설치를 시작하지 않습니다.
일반 → 새 버전 자동 확인·다운로드를 켜거나 끌 수 있습니다. 자동으로 다운로드해도 설치 전에는 항상 확인합니다. 무설치본의 업데이트는 새 배포본을 별도 폴더에서 사용하는 방식입니다. 도움말 → GitLinq 업데이트 확인에서도 공개 Release 정보를 확인할 수 있습니다.
이번 배포의 범위
- Windows 10/11 x64 미리보기입니다. Linux와 macOS 배포는 포함하지 않습니다.
- Git 작업은 화면에서 검토하고 실행할 수 있는 범위로 제한됩니다. 모든 저장소 구성, 인증 방식, 필터, 충돌 상황을 지원한다는 의미는 아닙니다. 지원하지 않거나 상태를 확정할 수 없으면 진행을 멈춥니다.
- AI는 로컬 모델 연결이 필요한 실험 기능입니다. 일반 Git 작업의 필수 구성요소가 아니며, 관리형 시험 모델은 사용자가 요청할 때 별도로 내려받습니다. 제품 품질을 보장하는 AI 배포가 아닙니다.
- SVN은 외부
svn.exe와 기존 작업 폴더의 로컬 정보·상태를 읽는 범위입니다. 완성된 SVN 쓰기 클라이언트와 SVN 바이너리는 포함하지 않습니다. - 새 서버 취소 실행은 기본값에서 비활성입니다. 이전 취소 작업은 화면에서 제공하는 결과 확인과 복구 흐름을 따르세요.
설정과 저장소는 앱 설치 폴더와 별도로 보관합니다
저장소 목록·그룹·메모·탭 상태, 설정과 저장된 작업은 %APPDATA%\GitLinq에 보관합니다. 무설치본도 같은 계정의 설치본과 이 데이터를 공유하므로 실행 폴더만 옮겨 설정까지 이전하는 방식은 아닙니다.
저장소 목록에서 제거할 때
제공되는 범위 중 목록에서만 제거, 로컬 폴더·목록 제거, 서버 저장소·로컬 폴더·목록 제거를 선택하고 대상과 계정을 검토합니다. 목록에서만 제거하면 파일과 서버 저장소는 유지합니다. 로컬 제거는 폴더 전체를 Windows 휴지통으로 이동합니다. 서버 삭제에는 지원되는 GitHub·GitLab 계정 연결과 대상 이름 확인이 필요하며, GitLab의 삭제 예약은 삭제 완료와 구분해 표시됩니다.
앱을 종료한 뒤 Windows 설정의 앱 목록에서 GitLinq를 제거하세요. 설정·저장된 작업·WebView2 사용자 데이터, 모든 저장소와 사용자 파일을 보존하며 Git·WebView2도 제거하지 않습니다. 다시 설치하면 남아 있는 데이터를 이어서 사용합니다.
궁금할 때만 읽는 Git 기초
이 내용을 전부 배운 뒤 시작할 필요는 없습니다. 사용하다 궁금해진 질문만 눌러 펼쳐 보세요.
SVN 커밋과 Git 커밋은 무엇이 다른가요?
SVN에서는 보통 커밋 한 번으로 서버에 변경을 보냅니다. Git에서는 먼저 내 PC에 변경 묶음을 남기는 커밋, 그 커밋을 서버에 보내는 푸시가 나뉘어 있습니다.
SVN의 일반적인 흐름
내 작업 파일 → 커밋 → 팀 서버
Git의 일반적인 흐름
내 작업 파일 → 로컬 커밋 → 푸시 → 팀 서버
그래서 Git에서 “커밋했어요”만으로는 동료가 서버에서 받을 수 있는 상태인지 알 수 없습니다. 서버로 보내는 단계도 완료되어야 합니다.
GitLinq 0.6.0에서는 변경 파일을 검토해 Stage하고 내 PC에 커밋한 뒤, 필요할 때 Push로 서버에 보냅니다. 커밋과 Push는 별도 작업입니다. 이전 변경을 되돌리는 취소 작업도 새로 수정한 파일을 커밋하는 작업과 구분합니다.
Git의 일반적인 흐름을 설명하는 예시입니다. 이 버튼은 실제 파일이나 서버를 바꾸지 않습니다.
파일을 수정했지만 아직 커밋하지 않았습니다. 서버와 동료의 PC에는 이전 내용이 있습니다.
내 파일, 로컬 커밋, 서버의 변경은 어떻게 다른가요?
표가 잘리면 좌우로 밀어 읽으세요.
| 위치 | 뜻 | 예시 |
|---|---|---|
| 내 작업 폴더 | 지금 편집기에서 보고 수정하는 파일 | 아직 커밋하지 않은 문구 수정 |
| 내 PC의 Git 로그 | 내 PC에 저장된 커밋 목록 | 로컬에만 있는 커밋, 이전에 서버에서 받은 커밋 |
| 팀 서버 | 동료들과 공유하는 커밋이 있는 곳 | 동료가 새로 보낸 변경, GitLinq가 반영한 취소 커밋 |
이 세 곳의 상태는 항상 같지 않습니다. 서버에서 취소해도 내 작업 폴더가 저절로 바뀌지는 않고, 저장소 업데이트로 서버 변경을 받아야 합니다. 반대로 내 PC에서 파일을 고쳤다고 곧바로 서버가 바뀌지도 않습니다.
커밋과 로그는 무엇인가요?
커밋은 “어떤 내용을 바꾸었는지”를 저장한 변경 묶음 하나입니다. 작성자와 설명이 붙어 있고, 로그에서는 그 묶음들을 순서대로 볼 수 있습니다.
Git은 각 커밋에 긴 영문·숫자 식별자인 해시를 붙입니다. 정확히 같은 커밋을 구별할 때 쓰지만, 처음 사용할 때 외울 필요는 없습니다. GitLinq에서는 작성자와 설명을 먼저 보고 내용을 확인하면 됩니다.
첫 커밋은 그 흐름의 시작이고, 병합 커밋은 나뉘어 진행한 작업 흐름을 합친 커밋입니다. 취소 가능한 작업은 커밋 종류와 저장소 상태에 따라 달라지므로 화면의 검토 결과를 확인하세요.
작성자와 서버에 보낸 사람은 같나요?
로그의 작성자는 해당 변경에 저장된 작성자 정보입니다. 그 커밋을 나중에 서버에 전송한 사람과 항상 같지는 않습니다. 예를 들어 내가 작성한 커밋을 다른 사람이 함께 서버에 보낼 수도 있습니다.
따라서 GitLinq의 나는 “이 변경의 작성자 이메일이 현재 저장소의 내 이메일과 같다”는 뜻입니다. “실제로 내가 푸시했다”는 증명은 아닙니다. 로그에 표시된 작성자를 실제 전송한 사람이라고 해석하지 마세요.
브랜치와 공유 위치는 무엇인가요?
브랜치는 한 저장소 안에서 이어지는 작업 흐름입니다. 팀은 하나의 흐름으로 함께 작업할 수도 있고, 기능별로 나누어 작업하다 합칠 수도 있습니다.
GitLinq는 선택한 저장소에서 현재 사용 중인 브랜치를 보여 줍니다. 서버와 연결할 때는 공유 위치도 표시합니다. 같은 프로젝트라도 공유 위치가 다르면 취소하거나 받아 올 대상이 달라질 수 있으므로 확인하는 것입니다.
브랜치를 새로 만들거나 바꾸는 방법을 몰라도 기존 저장소의 로그를 읽을 수 있습니다. 화면의 공유 위치가 팀에서 안내한 것과 다른지 모르겠다면 담당자에게 확인하세요.
‘중간 변경만 취소’하면 뒤의 작업은 어떻게 되나요?
서버에 반영된 순서
① 기본 화면 → ② 내 로그인 문구 수정 → ③ 동료의 알림 설정 추가
②만 취소할 수 있는 경우
① → ② → ③ → ④ 로그인 문구를 되돌리는 취소 커밋
②와 ③이 로그에서 사라지는 것은 아닙니다. ④를 새로 추가해 최종 파일 내용에서 ②의 효과를 되돌립니다. ③의 작업을 함께 없애지 않고 유지할 수 있는지 미리 확인합니다.
다만 ③이 ②에 꼭 필요한 내용을 추가했다면 둘을 깔끔하게 나눌 수 없을 수 있습니다. 예를 들어 ②가 새 파일을 만들고 ③이 그 파일을 수정했다면 파일만 지워서 해결할 수는 없습니다. 이런 경우 자동 취소 결과를 확정하지 않고 관련 내용을 보여 줍니다.
충돌이란 무엇인가요?
서로 다른 변경을 합치거나 일부를 되돌릴 때 어느 내용을 남겨야 하는지 자동으로 결정하기 어려운 상황입니다. 같은 줄을 다르게 고치거나, 한쪽에서는 없앨 파일을 다른 쪽에서는 수정한 경우가 예입니다.
충돌 안내가 나온다고 저장소 전체가 고장 난 것은 아닙니다. 사람이 원래 의도를 확인해야 한다는 뜻입니다. 화면의 충돌·복구 안내에 따라 변경 내용을 검토하세요. 실행할 수 있는 작업은 현재 저장소 상태와 지원 조건에 따라 달라집니다.
‘복제’와 ‘업데이트’는 다른가요?
복제(Clone)는 서버의 Git 저장소를 내 PC에 처음 준비하는 일입니다. SVN에서 처음 작업 사본을 받는 용도와 비슷하지만 Git의 동작과 용어가 완전히 같지는 않습니다.
업데이트는 이미 내 PC에 있는 저장소에 서버의 새 변경을 받아 적용하는 일입니다. GitLinq 0.6.0에서는 Git 복제로 처음 저장소를 준비하고, 기존 저장소의 서버 변경은 Fetch와 Pull에서 확인합니다.
Git과 GitHub는 같은 건가요?
Git은 변경 내역을 관리하는 프로그램입니다. GitHub는 Git 저장소를 서버에 보관하고 함께 작업할 수 있도록 하는 서비스 중 하나입니다.
회사는 GitHub 대신 다른 서비스나 사내 Git 서버를 사용할 수도 있습니다. Git을 쓴다고 반드시 GitHub 계정을 만들어야 하는 것은 아닙니다. 팀에서 사용하는 서버와 접근 방법을 확인하면 됩니다.
GitLinq의 공개 설치 파일을 GitHub에서 받는 것과, 회사 프로젝트 저장소에 접속하는 것도 별개의 일입니다. 공개 GitLinq 다운로드에는 GitHub 로그인이 필요하지 않지만, 프로젝트 서버에는 그 서버가 요구하는 접근 권한이 필요할 수 있습니다.