Kept saves your AI conversations as local Markdown files, then gives you a desktop app to search, browse, connect, and reuse them.
It works with ChatGPT, Claude, Gemini, Grok, and Kimi. Your archive lives on your machine under ~/.kept/, with an Obsidian-compatible vault plus local indexes for full-text search, topics, projects, and graph views.
AI chats often become working memory: debugging trails, research notes, product decisions, prompts, snippets, and half-finished ideas. Most of that history stays inside vendor UIs.
Kept turns it into files you own.
Plain Markdown, grouped by provider.
Fast local search with SQLite FTS5.
Graph and topic views for finding connections across old conversations.
Optional chat over your own archive using the model provider you configure.
An MCP server so coding agents can read, search, and manage the vault.
How It Works
Chromium browser extension
-> reads conversations from provider API endpoints using your signed-in session
-> normalizes messages and supported image assets
-> sends them to the Kept desktop app on http://localhost:18241
Kept desktop app
-> writes Markdown files to ~/.kept/vault/
-> indexes content in SQLite
-> builds a local knowledge graph in CozoDB
-> exposes search, graph, project, export, and agent tools
MCP server
-> lets Claude Code, OpenClaw, and other MCP clients work with the vault
Kept does not scrape rendered chat pages. The extension syncs conversation data from provider API responses and hands the normalized payload to the local app.
Supported Providers
Provider
Sync
Notes
ChatGPT
Yes
Full conversations, streaming history, branch-aware saves
Claude
Yes
Full conversations and streaming history
Gemini
Yes
Best effort; Google's API format changes often
Grok
Yes
Includes supported image assets
Kimi
Yes
Uses the Kimi auth helper included in the extension
Provider APIs are private and can change without notice. Kept keeps the archive as plain files so your saved conversations stay readable even if an adapter needs an update.
Quick Install
Windows PowerShell:
irm https://kept.work/install.ps1 | iex
macOS and Linux:
curl -fsSL https://kept.work/install.sh | bash
The installer downloads the latest GitHub Release, installs the desktop app, and extracts the Chromium extension to a local folder. Browsers still require you to load the extension manually in Developer Mode.
You can open ~/.kept/vault/ directly in Obsidian, VS Code, or any editor. The files are the source of truth; the search and graph databases can be rebuilt from them.
MCP Server
mcp/ is an MCP server named kept-vault-server. It lets agentic clients list, read, write, search, rename, and delete files in your Kept vault.
build-essential, clang, and libclang-dev are required for Rust crates that
use bindgen (e.g. zstd-sys pulled in by CozoDB). The rest are the GTK /
WebKitGTK / GLib stack Tauri 2 links against.
Then run:
npm run tauri:dev:linux
Frontend-Only Mode
You can run the UI against mock data without the Rust app:
cd app
npm ci
npm run dev
Vite serves the UI at http://localhost:1420.
Repository Layout
app/ Tauri 2 desktop app
src/ React frontend
src-tauri/ Rust backend, Axum server, vault, search, graph, agent tools
extension/ Chromium extension
platforms/ Provider sync adapters
mcp/ MCP server for the vault
scripts/ App and MCP install scripts
Privacy And Security
Core archive and search data stays on your machine in ~/.kept/.
The extension talks to the desktop app over localhost and must include the bearer token stored at ~/.kept/token.
Kept has no hosted account and no cloud sync.
Optional chat, topic discovery, and graph features call only the model provider you configure, or your local Ollama server.
The updater checks the configured Kept update endpoint for new desktop releases.
Contributing
Issues and pull requests are welcome. Conventional commits are preferred:
feat(scope): add ...
fix(scope): repair ...
Useful areas to start:
extension/platforms/ for provider adapters
app/src-tauri/src/vault.rs for vault writes
app/src-tauri/src/db.rs for search indexing
app/src-tauri/src/kg-gen/ for graph generation
mcp/src/ for MCP vault tools
License
MIT
K
Kept
egroup-labs·147 estrellas·
Search, archive, and recall your AI conversations. ChatGPT, Claude, Gemini, Grok, Kimi. Local-first, MIT licensed.
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo Kept?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿Kept necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa Kept?
Kept se ejecuta localmente por stdio.
¿Cuándo se comprobó Kept por última vez?
Última comprobación: 2026-10-26. Search, archive, and recall your AI conversations. ChatGPT, Claude, Gemini, Grok, Kimi. Local-first, MIT licensed.