kept

Overview

Kept preserves AI conversations from ChatGPT, Claude, Gemini, Grok, and Kimi as local Markdown files. It offers a desktop application for searching, browsing, and connecting conversations with full-text search, graph views, and topic organization. The MCP server provides tools for agents to read, search, and manage the vault, enabling coding agents to work with archived conversations directly.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• list_vault

  List all available providers and directories in the Kept vault

  Try:List all directories in my vaultTry:What providers do I have in Kept?
• list_directory

  List files in a specific directory in the vault

  Try:List files in my ChatGPT directoryTry:What conversations are in my Claude folder?
• read_file

  Read the content of a specific file in the vault

  Try:Read my conversation about CUDA kernelsTry:Show me the content of the 2026-05-02_kept-readme-draft.md file
• write_file

  Write a new file to the vault

  Try:Create a new conversation fileTry:Save this prompt to my vault
• update_file

  Update an existing file in the vault

  Try:Add notes to an existing conversationTry:Update a file with new information
• delete_file

  Delete a file from the vault

  Try:Remove an old conversation fileTry:Delete a file from my vault
• move_file

  Move a file to a different location in the vault

  Try:Move a file to a different provider directoryTry:Reorganize my vault structure
• grep_vault

  Search for content across the entire vault

  Try:Search for conversations about React hooksTry:Find all files mentioning machine learning

Comparable tools

Installation

# macOS/Linux
curl -fsSL https://kept.work/install.sh | bash

# Windows PowerShell
irm https://github.com/egroup-labs/kept/releases/latest/download/install.ps1 | iex

# macOS/Linux
bash <(curl -fsSL https://raw.githubusercontent.com/egroup-labs/kept/main/scripts/install-kept-mcp.sh)

# Windows PowerShell
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/egroup-labs/kept/main/scripts/install-kept-mcp.ps1)))

{
  "mcpServers": {
    "kept-vault": {
      "command": "npx",
      "args": ["@kept-plugins/kept-vault"]
    }
  }
}

FAQ

How does Kept handle privacy?

All data stays locally on your machine in ~/.kept/. No cloud sync or hosted accounts.

What file format are conversations saved as?

Conversations are saved as plain Markdown files with YAML frontmatter, compatible with Obsidian.

Can I access my vault from other tools?

Yes, the vault is just a folder of Markdown files that can be opened directly in VS Code, Obsidian, or any editor.

On Hacker News

Recent discussion from the developer community.

• Show HN: A Local-First Agentic Knowledge Manager▲ 16💬 2
  Story by Mapika · 2026-05-08

Compare kept with