토큰 낭비 없는 AI 코딩 복구, git 기반 자동 체크포인트 ckpt

Context

AI 에이전트의 다수 파일 동시 수정 시 오류 발생 시 복구 수단 부재. 기존 IDE 복구 기능은 UI 기반으로 AI 에이전트가 직접 제어 불가능. 오류 수정 과정에서 불필요한 파일 재읽기로 인한 토큰 소모 발생.

Technical Solution

• git의 숨겨진 브랜치와 커밋을 활용하여 세션 내 모든 변경 사항을 스냅샷으로 저장하는 구조
• CLI 기반 인터페이스 설계로 AI 에이전트가 셸 명령어를 통해 스스로 상태를 복원하는 self-correcting 메커니즘 구현
• ckpt watch 명령어로 변경 사항을 실시간 추적하고 ckpt restore를 통해 특정 스텝으로 즉시 회귀하는 워크플로우
• ckpt try 명령어를 통한 분기 생성 및 ckpt trydiff를 활용한 서로 다른 접근 방식의 코드 비교 기능
• 세션 종료 시 ckpt end 명령어로 개별 커밋들을 하나의 깨끗한 git commit으로 병합하는 squash 전략
• 별도의 데이터베이스 없이 git 저장소만 활용하여 환경 설정 최소화 및 이식성 확보

Impact

• 오류 복구 시 소모되던 500-2000 tokens 비용을 0 tokens로 절감
• 수동 복구 대비 밀리초(milliseconds) 단위의 즉각적인 상태 복원 달성

Key Takeaway

인간 중심의 UI 도구를 CLI 인터페이스로 추상화함으로써 AI 에이전트에게 시스템 제어 권한을 부여하고 자가 치유 능력을 극대화하는 설계 방식.