AIRGAP StudioAIRGAP Studio

Git 체크포인트

Git 설치 및 체크포인트 기능 문제 해결

체크포인트 기능이란?

AIRGAP Assistant는 AI가 파일을 수정할 때 자동으로 Git 체크포인트를 생성합니다. 이 기능을 통해 언제든지 이전 상태로 되돌릴 수 있어 안전하게 AI 기반 코드 수정을 수행할 수 있습니다.

체크포인트 기능을 사용하려면 Git이 시스템에 설치되어 있어야 합니다.

Git 설치

에어갭 환경에서의 설치 (Portable Git)

네트워크가 차단된 환경에서는 Portable Git을 사용합니다.

  1. 사전에 다운로드한 PortableGit-x.xx.x-64-bit.7z.exe 파일을 준비합니다.
  2. 원하는 경로에 압축을 풀어둡니다 (예: C:\PortableGit).
  3. 시스템 PATH에 Git 경로를 추가합니다.
# 시스템 PATH에 Git 추가 (관리자 권한 필요)
[Environment]::SetEnvironmentVariable(
  "PATH",
  "$env:PATH;C:\PortableGit\bin",
  "User"
)
  1. AIRGAP Studio를 재시작합니다.

설치 확인

git --version

버전 정보가 표시되면 정상적으로 설치된 것입니다.

체크포인트 설정

Git 초기 설정

Git을 처음 사용할 때 사용자 정보를 설정해야 합니다.

git config --global user.name "사용자 이름"
git config --global user.email "user@example.com"

프로젝트에서 Git 초기화

체크포인트 기능은 Git 리포지토리에서만 작동합니다. 프로젝트 폴더에서 Git을 초기화하세요.

cd C:\your-project
git init
git add .
git commit -m "initial commit"

일반적인 문제 해결

"Git이 설치되어 있지 않습니다"

확인 사항조치
Git 설치 여부git --version 실행
PATH 설정Git 실행 파일 경로가 PATH에 포함되어 있는지 확인
IDE 재시작PATH 변경 후 AIRGAP Studio 재시작

체크포인트가 생성되지 않음

  1. 현재 폴더가 Git 리포지토리인지 확인합니다.
git status

fatal: not a git repository 메시지가 나타나면 git init으로 초기화하세요.

  1. .gitignore 파일이 수정 대상 파일을 무시하고 있는지 확인합니다.

체크포인트로 되돌리기

AIRGAP Assistant 대화 내역에서 체크포인트 표시를 찾아 Restore 버튼을 클릭하면 해당 시점으로 되돌릴 수 있습니다.

수동으로 되돌리려면 터미널에서 Git 명령어를 사용합니다.

# 최근 변경 취소 (커밋되지 않은 변경)
git checkout -- .

# 특정 커밋으로 되돌리기
git log --oneline
git checkout <commit-hash>

Git 인증 관련 오류

체크포인트는 로컬 Git 작업이므로 원격 리포지토리 인증은 필요하지 않습니다. 인증 관련 오류가 나타나면 git push 등의 원격 작업을 시도하고 있는지 확인하세요.

관련 문서