Skip to main content

Installation

Requirements​

  • VS Code 1.96 or later
  • At least one supported AI CLI installed:
    • Claude Code (Anthropic)
    • Codex (OpenAI)
    • Gemini CLI (Google)

Install from Marketplace​

  1. Open VS Code
  2. Go to Extensions (Ctrl+Shift+X)
  3. Search for "Klip"
  4. Click Install

Or install directly:

Install from VSIX​

For manual installation from a .vsix file:

code --install-extension klip-x.y.z.vsix

Or in VS Code:

  1. Go to Extensions (Ctrl+Shift+X)
  2. Click the ... menu
  3. Select Install from VSIX...
  4. Choose the .vsix file

Verify Installation​

After installation:

  1. Look for the Klip icon in the Activity Bar (left sidebar)
  2. Open the Command Palette (Ctrl+Shift+P)
  3. Search for "Klip" - you should see Klip commands

First Launch​

On first launch, Klip will:

  1. Detect installed CLIs - Scans for Claude, Codex, and Gemini
  2. Start the daemon - Background service for indexing
  3. Discover sessions - Scans default session directories

If you have existing sessions, they should appear in the sidebar within a few seconds.

Updating​

Klip updates automatically through VS Code's extension update mechanism.

To manually check for updates:

  1. Go to Extensions (Ctrl+Shift+X)
  2. Click the ... menu
  3. Select Check for Extension Updates

Uninstalling​

To uninstall Klip:

  1. Go to Extensions (Ctrl+Shift+X)
  2. Find Klip
  3. Click Uninstall

Clean Uninstall​

To also remove Klip's data:

Linux/macOS/WSL:

# Stop the daemon
kp shutdown

# Remove Klip data directory
rm -rf ~/.klip

Windows (PowerShell):

# Stop the daemon
kp shutdown

# Remove Klip data directory
Remove-Item -Recurse -Force "$env:USERPROFILE\.klip"
caution

This removes all Klip metadata including summaries, tags, and embeddings. Session files (stored by the AI CLIs) are not affected.

Next Steps​