Gemini CLI - /restore 동작 안함 : macOS

관련 버전

Gemini CLI 의 0.22.2 - 0.22.4 임.

---

checkpointing 기능 관련 버그.

macOS 에서만

• /restore 동작을 사용하기 위해서 settings.json을 수정하면
• Promise (비동기작업) 에러가 나면서 초기화가 되지 않아서 사용을 할 수가 없음.

WSL에서 수행하는 경우는 잘 동작하는데... ==;;

 

user global configuration인 settings.json 이 있는 디렉토리는 ~/.gemini 임.

현재 해결방안이 안 보이는 터라 우선 settings.json에서 다음과 같이 checkpointing을 활성화해선 안된다.

{
  "security": {
    "auth": {
      "selectedType": "oauth-personal"
    }
  },
  "general": {
    "previewFeatures": true,
    "checkpointing": {
        "enabled": true
    }
  }
}

• 이전에는 --checkpointing 옵션을 주고 실행하여 /restore 명령어를 활성화할 수 있었으나,
• 현재는 settings.json에서 위와 같이 general.checkpoining 에 "enabled": true로 설정해야 함.
• 문제는 macOS에서 안된다.

에러는 gemini로 Gemini CLI를 시작시키면 발생함:

---

관련 자료

/restore 명령어를 위한 checkpointing 기능에 대한 자세한 건 다음을 참고:
https://geminicli.com/docs/cli/checkpointing/

Checkpointing

---

2025.12.26 - [개발환경] - Gemini CLI 설치 가이드 (Homebrew 이용)

Gemini CLI 설치 가이드 (Homebrew 이용)

---