Skip to main content

First-time Setup

1) Install at least one AI CLI​

Klip detects CLI tools available on your machine. If none are installed, install at least one of:

  • Claude Code
  • Codex
  • Gemini CLI

2) Verify session discovery defaults​

Default locations are always searched:

  • ~/.claude/projects
  • ~/.codex/sessions
  • ~/.gemini/tmp

Optionally, add extra paths in settings (useful for backups or shared drives).

3) Configure API keys (optional)​

You don’t need API keys to browse or resume sessions, but you will need them for optional features:

  • Summaries: default model is Gemini (gemini-2.5-flash), which uses a Gemini API key (no CLI login required)
  • Embeddings / semantic search: requires either a Gemini or OpenAI API key

See: API keys (summaries & embeddings)

4) Open Klip in VS Code​

Open the Klip sidebar and refresh to see sessions populate.