AI 도구 & CLI 가이드·약 5분 내외

Antigravity CLI (agy) 이전 작업 세션 복원하기 — /resume과 -c 완벽 가이드

터미널이 꺼지거나 SSH 연결이 끊겨도 이전 작업 컨텍스트와 대화 내역을 살려내는 Antigravity CLI의 세션 복원법(/resume, -c, --conversation)과 실무 팁을 정리합니다.

아키텍처 구조도

다이어그램 렌더링 중...

배경: 터미널이 끊겨도 에이전트의 기억은 살아있다

원격 서버에서 SSH로 작업하다가 네트워크가 불안정해 터미널이 끊기거나, 실수로 창을 닫았을 때 AI 에이전트에게 처음부터 프로젝트 상황을 다시 설명해야 한다면 큰 시간 낭비가 발생합니다.

Antigravity 세션 스토리지 원리

Google Antigravity CLI(`agy`)는 모든 대화 내역, 탐색한 코드, 수정 히스토리를 로컬 저장소에 세션(Conversation) 단위로 자동 기록합니다. 세션 복원 명령을 사용하면 이전 두뇌 상태 그대로 작업을 이어갈 수 있습니다.

방법 1: 대화창 내부에서 이전 세션 불러오기 (/resume)

CLI를 이미 실행한 상태에서 터미널을 나가지 않고 이전 대화 세션으로 전환할 때 가장 편리한 슬래시 커맨드입니다.

CLI 프롬프트 입력창에서 실행

# 대화창에 입력하여 이전 세션 탐색 및 재개
/resume

명령어를 입력하면 최근 진행했던 대화 목록이 대화형 메뉴로 표시되며, 방향키(↑/↓)로 원하는 작업 세션을 선택해 즉시 해당 컨텍스트로 복귀할 수 있습니다.

방법 2: 터미널 시작 시 직전 세션 즉시 이어하기 (-c, --continue)

새 터미널을 열었을 때 바로 직전에 작업하던 대화를 이어서 시작하고 싶다면 실행 플래그를 사용합니다.

셸에서 직접 실행

# 직전 작업 세션 즉시 복원 (단축형)
agy -c

# 풀 네임 옵션
agy --continue

실무 주의사항

`-c` 옵션은 마지막으로 작업했던 디렉토리 컨텍스트를 불러오므로, 이전에 작업하던 해당 프로젝트 폴더로 이동한 후 실행하는 것이 좋습니다.

방법 3: 특정 과거 세션 ID로 골라서 들어가기 (--conversation)

며칠 전 작업했던 특정 기능 개발 세션이나 버그 픽스 세션의 대화 ID(UUID)를 알고 있다면, 해당 세션을 직접 지정해 복원할 수 있습니다.

특정 세션 복원 및 ID 탐색 원라이너

# 1. 최근 작업한 세션 ID(폴더명) 최신순 확인
ls -lt ~/.gemini/antigravity-cli/brain/ | head -n 5

# 2. 특정 세션 ID로 진입
agy --conversation 36a064fe-c3f3-4f72-8cf4-20d91a2a7944

실무 주의사항: 세션 복원 시 생길 수 있는 함정

✕피해야 할 습관

✕Git 브랜치를 다른 브랜치로 전환한 상태에서 확인 없이 이전 세션을 복원해 코드 수정을 지시하는 것
✕하나의 세션을 몇 주 동안 끝없이 이어 써서 컨텍스트 토큰이 과도하게 팽창되고 추론 속도가 느려지는 것

✓권장하는 실무 수칙

✓세션을 재개하기 전 항상 git status 로 현재 브랜치와 워크스페이스 상태를 먼저 점검
✓하나의 세션은 "특정 이슈 해결" 단위로 매듭짓고, 작업 완료 후에는 새 세션(agy)을 시작해 컨텍스트를 리프레시

세션 복원은 작업 연속성을 지켜주지만, 대규모 작업이 끝난 뒤에는 새 세션을 시작하는 것이 에이전트의 환각(Hallucination) 방지와 토큰 비용 최적화에 유리합니다.

DevOps & AI 엔지니어링팀

개발 생산성 가이드

장시간 이어지는 리팩토링이나 디버깅 작업 시 세션 복원 기능은 필수입니다. 이미 켜진 CLI에서는 /resume을, 터미널을 다시 켤 때는 agy -c를 기억하세요.