Data Locations

This reference describes where Klip and AI agents store data on your system.

Klip Data

All Klip data is stored locally. Nothing is uploaded to Klip servers except feedback submissions and license validation.

Core Data

Data	Location
Database	~/.klip/klip.db (plus -wal, -shm)
Config	~/.klip/config.json
Layouts	~/.klip/layouts/
Cells	~/.klip/cells/
Logs	~/.klip/logs/
Admin Token	~/.klip/admin.token

Database Contents

The SQLite database (~/.klip/klip.db) stores:

• Session metadata (not content)
• Summaries
• Embeddings (vector search)
• Tags and notes
• File tracking data
• Button Library definitions

Agent Session Files

AI agents store their session data independently of Klip.

Agent	Location	Format
Claude	~/.claude/projects/<workspace>/<session>.jsonl	JSONL
Codex	~/.codex/sessions/<year>/<month>/<day>/<session>.jsonl	JSONL
Gemini	~/.gemini/tmp/<workspace-hash>/chats/<session>.json	JSON

Path Encoding

• Claude encodes the workspace path in the directory name
• Codex organizes by date
• Gemini uses a SHA256 hash of the workspace path

Custom Session Paths

If you use non-standard CLI installations, configure additional paths:

Setting: klip.additionalSessionPaths

"klip.additionalSessionPaths": [
  "/custom/path/to/sessions"
]

File Tracking

Klip tracks which files are read and modified during sessions.

What's Tracked

Type	Description
Files Modified	Files written or edited by the AI
Files Read	Files read for context

Configuration

Setting	Default	Description
klip.fileTracking.enabled	true	Enable/disable file tracking
klip.fileTracking.storeBackupContent	true	Store file content for restore (Pro)
klip.fileTracking.backupMaxFileSizeKb	512	Max file size for backups

Excluding Files

Prevent tracking of specific files:

"klip.fileTracking.excludePatterns": [
  "*.lock",
  "package-lock.json",
  "node_modules/**",
  "dist/**"
]

Excluded files appear in tool logs but aren't backed up or highlighted in summaries.

Exports

Session File

Open the raw session JSON/JSONL:

• Command: Klip: Open Session File (klip.openSessionFile)
• Action: Right-click session > Open Session File

Audit Report

Generate a text-based audit report:

• Command: Klip: Audit Session (klip.auditSession)

Safe Cleanup

Clear Cache

Force re-scan of sessions if data seems inconsistent:

• Command: Klip: Clear Session Cache (klip.clearSessionCache)

Delete Sessions

Permanently remove a session and its metadata:

• Command: Klip: Delete Session (klip.deleteSession)
• Action: Right-click session > Delete Session

caution

Deletion removes both the session file and database records. This cannot be undone.

Related

• Dashboard: Account - Privacy information
• Troubleshooting - Common issues