Overview
Klip is a VS Code extension for browsing, resuming, searching, and organizing AI coding sessions from Claude Code, Codex, and Gemini.
What Klip Does
| Feature | Description |
|---|---|
| Session Discovery | Automatically finds sessions from all installed AI CLIs |
| Resume Sessions | Continue where you left off with one click |
| Search | Find sessions by keyword or semantic meaning |
| Summaries | AI-generated summaries to remember context |
| Multi-Session | Work with multiple sessions in grid layouts |
| MCP Management | Configure MCP servers across agents |
Supported AI Agents
| Agent | CLI | Session Format |
|---|---|---|
| Claude | Claude Code (Anthropic) | JSONL |
| Codex | Codex CLI (OpenAI) | JSONL |
| Gemini | Gemini CLI (Google) | JSON |
Architecture
Klip consists of two components:
VS Code Extension
- Sidebar navigation
- Webview panels (Klip Panel, Dashboard, Sessions Explorer)
- VS Code integration (commands, settings, terminals)
Local Daemon (kp)
- Session indexing and database
- Vector search (embeddings)
- Summary generation
- MCP server management
The daemon starts automatically when needed and runs in the background.
Key Concepts
Local-First
All data is stored locally. Klip never uploads your code or session history. The only external calls are:
- AI API requests for summaries/embeddings (to provider you configure)
- License validation (for Pro features)
- Feedback submission (when you choose to send)
Cross-Environment Support
Klip works across Windows, WSL, macOS, and Linux. Sessions from different environments in the same workspace are grouped together.
Session Discovery
Klip scans default CLI directories plus any custom paths you configure. Sessions are indexed into a local SQLite database for fast access.
Free vs Pro
| Feature | Free | Pro |
|---|---|---|
| Session browsing | Yes | Yes |
| Resume sessions | Yes | Yes |
| Keyword search | Yes | Yes |
| AI summaries | Yes | Yes |
| Klip Panel | Yes | Yes |
| MCP management | Yes | Yes |
| Advanced Analytics | - | Yes |
| Session History Viewer | - | Yes |
| Tags (env vars, init scripts) | - | Yes |
| Button Library | - | Yes |
| Daemon API Keys | - | Yes |
| MCP Gateway | - | Yes |
Next Steps
- Installation - Install from Marketplace
- First-time Setup - Configure CLIs and API keys