Skip to main content

Sessions Explorer

The Sessions Explorer is Klip's comprehensive session browser with filtering, search, and batch operations.

Command: Klip: Open Sessions Explorer (klip.openSessionsExplorer)

Overview​

Unlike the Sidebar which focuses on the current workspace, the Sessions Explorer shows all sessions across all workspaces and agents.

Filtering​

Filter sessions by:

  • Agent: Claude, Codex, Gemini (or all)
  • Workspace: Filter to specific project directories
  • Date Range: Last 24h, 7 days, 30 days, custom
  • Status: Active, archived, or all

Search for exact words or phrases across session content. Fast and requires no API keys.

When an embedding provider is configured, you can search using natural language:

"How did I fix the authentication bug?"

Semantic search finds conceptually related content even when exact keywords don't match.

Requirements:

  • Configure an embedding provider (Gemini or OpenAI)
  • See API Keys for setup

Search Settings​

"klip.search.defaultTypes": "sessions,summaries",
"klip.search.defaultLimit": 500

Embeddings Configuration​

To enable semantic search, configure an embedding provider:

  1. Get a free API key from Google AI Studio
  2. Run: Klip: Configure Gemini API Key
  3. Select scope and restart daemon when prompted

OpenAI​

  1. Get an API key from OpenAI Platform
  2. Set klip.ai.openaiApiKey in VS Code settings

Provider Selection​

"klip.ai.embeddingProvider": "auto"  // or "gemini" or "openai"
  • auto: Prefers OpenAI if both keys are configured
  • gemini: Forces Gemini embeddings
  • openai: Forces OpenAI embeddings
Re-indexing Required

Switching embedding providers requires re-indexing because vector dimensions differ (OpenAI: 1536, Gemini: 768). Run Klip: Force Refresh Sessions (Clear Cache) after switching.

Session Actions​

From the explorer, you can:

  • Open Details - View session summary and stats
  • Resume - Launch terminal to continue the session
  • Rename - Give the session a meaningful name
  • Archive - Hide from default views
  • Delete - Permanently remove session and logs