Checkpoints

Kiro에 프롬프트를 보낼 때마다 자동으로 생성되는 복원 지점으로, 코드와 대화 맥락을 이전 상태로 되돌릴 수 있는 안전 장치입니다.

Checkpoint란 무엇인가

Checkpoint는 사용자가 Kiro에 프롬프트를 전송할 때마다 채팅 기록에 자동으로 남는 표식입니다. 단순한 히스토리 기록을 넘어, 해당 시점의 작업 공간 상태로 되돌리는 안전망 역할을 합니다. 덕분에 한 가지 문제를 여러 방식으로 시도해 보거나, 동일한 작업을 서로 다른 모델로 실험하거나, 에이전트가 의도와 다르게 동작했을 때 부담 없이 이전 상태로 복귀할 수 있습니다.

동작 방식

  1. 프롬프트를 전송하면 자동으로 새로운 checkpoint 표식이 채팅 기록에 추가됩니다.
  2. 에이전트가 내장 파일 수정 도구로 파일을 변경할 때, 해당 파일의 스냅샷이 함께 저장됩니다.
  3. 이전 시점으로 돌아가려면 채팅 기록의 checkpoint 표식에 있는 Restore 버튼을 누릅니다.
  4. 복원이 실행되면 그 시점 이후에 에이전트가 만든 코드 변경이 모두 되돌려지고, 그 사이에 쌓인 채팅 상호작용과 맥락도 함께 폐기됩니다.
Tip. 새로운 접근법을 시험하기 전에 현재 위치의 checkpoint를 한 번 확인해 두면, 실험이 잘 안 풀려도 단 한 번의 클릭으로 원래 자리로 돌아올 수 있습니다.

추적되지 않는 변경

Kiro는 자체 에이전트 도구를 통해 발생한 파일 수정만 스냅샷에 담습니다. 따라서 다음과 같이 에이전트 외부에서 발생한 변경은 추적 대상이 아니며, 복원 시 함께 되돌릴 수 없습니다.

주의. 위 경로로 발생한 변경은 checkpoint에 포함되지 않습니다. Restore를 누르면 해당 변경분은 추적되지 않은 상태로 사라질 수 있으니, 중요한 수동 편집이 끼어 있다면 별도로 보존하세요.

Revert와 Checkpoint의 차이

에이전트가 파일 수정을 마친 직후에는 채팅 입력창 바로 위에 Revert 옵션이 나타납니다. Revert와 Checkpoint는 비슷해 보이지만 되돌리는 범위가 다릅니다.

구분RevertCheckpoints
되돌리는 범위가장 최근 에이전트 턴 한 번만여러 턴에 걸친 시점
되돌리는 대상파일 변경에 한정파일 변경과 추가된 대화 맥락 모두

언제 어떤 기능을 쓰면 좋은가