Skip to main content

Troubleshooting

Sessions not appearing

  • Verify session directories exist and contain files
  • Verify additional paths (if used)
  • Refresh/reload VS Code and check Klip output logs

Resume fails

  • Verify the agent CLI is installed and authenticated
  • Verify the session file exists
  • Try a different shell configuration

Daemon connection issues (Pro/backend features)

  • Confirm the daemon is running (or allow Klip to start it)
  • Check ~/.klip/logs/ for errors

Summaries fail (Gemini)

  • Confirm a Gemini API key is configured (recommended: Klip: Configure Gemini API Key)
  • If using environment variables, set KLIP_GEMINI_API_KEY (or KLIP_GEMINI_API_KEY_SUMMARIES for a dedicated summaries key)
  • Restart the Klip daemon after changing keys