Skip to content
Back to search

kept

Search, archive, and recall your AI conversations. ChatGPT, Claude, Gemini, Grok, Kimi. Local-first, MIT licensed.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/egroup-labs--kept/badge.svg)](/listings/egroup-labs--kept)

HTML

<a href="/listings/egroup-labs--kept"><img src="/api/listings/egroup-labs--kept/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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.

The same scripts can be run directly from GitHub:

irm https://raw.githubusercontent.com/egroup-labs/kept.work/main/scripts/install.ps1 | iex
curl -fsSL https://raw.githubusercontent.com/egroup-labs/kept.work/main/scripts/install.sh | bash

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "kept-plugins",
  3. "owner": {
  4. "name": "egroup-labs"
  5. },
  6. "plugins": [
  7. {
  8. "name": "kept-vault",
  9. "source": "./mcp",
  10. "description": "Read, write, search, and manage your Kept conversation vault",
  11. "version": "1.0.0"
  12. }
  13. ]
  14. }
README.md · README · 279 lines · 5 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Kept
  2. <a href="https://www.producthunt.com/products/kept-ai-on-your-local-conversations?utm_source=badge-follow&utm_medium=badge&utm_source=badge-kept&#0045;ai&#0045;on&#0045;your&#0045;local&#0045;conversations" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/follow.svg?product_id=1228638&theme=neutral" alt="Kept - Your&#0032;AI&#0032;chats&#0044;&#0032;saved&#0032;as&#0032;Markdown&#0032;locally&#0032;with&#0032;no&#0032;cloud | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
  3. <p align="center">
  4. <img src="demo.gif" alt="Kept archival illustration" width="100%" style="border-radius:20px;">
  5. </p>
  6. Kept saves your AI conversations as local Markdown files, then gives you a desktop app to search, browse, connect, and reuse them.
  7. 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.
  8. [Quick Install](#quick-install) | [Download](#download) | [Setup](#setup) | [Build from source](#build-from-source) | [MCP server](#mcp-server)
  9. ## Why Kept
  10. 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.
  11. Kept turns it into files you own.
  12. - Plain Markdown, grouped by provider.
  13. - Fast local search with SQLite FTS5.
  14. - Graph and topic views for finding connections across old conversations.
  15. - Optional chat over your own archive using the model provider you configure.
  16. - An MCP server so coding agents can read, search, and manage the vault.
  17. ## How It Works
  18. ```
  19. Chromium browser extension
  20. -> reads conversations from provider API endpoints using your signed-in session
  21. -> normalizes messages and supported image assets
  22. -> sends them to the Kept desktop app on http://localhost:18241
  23. Kept desktop app
  24. -> writes Markdown files to ~/.kept/vault/
  25. -> indexes content in SQLite
  26. -> builds a local knowledge graph in CozoDB
  27. -> exposes search, graph, project, export, and agent tools
  28. MCP server
  29. -> lets Claude Code, OpenClaw, and other MCP clients work with the vault
  30. ```
  31. 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.
  32. ## Supported Providers
  33. | Provider | Sync | Notes |
  34. | --- | --- | --- |
  35. | ChatGPT | Yes | Full conversations, streaming history, branch-aware saves |
  36. | Claude | Yes | Full conversations and streaming history |
  37. | Gemini | Yes | Best effort; Google's API format changes often |
  38. | Grok | Yes | Includes supported image assets |
  39. | Kimi | Yes | Uses the Kimi auth helper included in the extension |
  40. 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.
  41. ## Quick Install
  42. Windows PowerShell:
  43. ```powershell
  44. irm https://kept.work/install.ps1 | iex
  45. ```
  46. macOS and Linux:
  47. ```bash
  48. curl -fsSL https://kept.work/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 72 on GitHub
  49. ```
  50. 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.
  51. The same scripts can be run directly from GitHub:
  52. ```powershell
  53. irm https://raw.githubusercontent.com/egroup-labs/kept.work/main/scripts/install.ps1 | iex
  54. ```
  55. ```bash
  56. curl -fsSL https://raw.githubusercontent.com/egroup-labs/kept.work/main/scripts/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 84 on GitHub
  57. ```
  58. ## Download
  59. Desktop builds are published on [GitHub Releases](https://github.com/egroup-labs/kept.work/releases/latest).
  60. Current release targets:
  61. - macOS Apple Silicon: `.dmg`
  62. - Windows x64: NSIS `.exe` installer
  63. - Linux x64: `.deb` and `.AppImage`
  64. The release also includes the Chromium extension package. Until the Web Store listing is live, install the extension in developer mode.
  65. ## Setup
  66. ### 1. Install The Desktop App
  67. Use the [Quick Install](#quick-install) command above, or download the build for your OS from [Releases](https://github.com/egroup-labs/kept.work/releases/latest), install it, and launch Kept.
  68. On first launch, Kept creates:
  69. ```
  70. ~/.kept/
  71. vault/
  72. index.db
  73. kg.db/
  74. config.toml
  75. token
  76. ```
  77. The app also starts a local server on `http://localhost:18241`. The browser extension uses this local server to send conversations into the vault.
  78. ### 2. Load The Browser Extension
  79. Kept supports Chromium-based browsers: Chrome, Brave, Edge, Vivaldi, Arc, Opera, and Chromium.
  80. 1. Extract the extension from the release, or use `extension/` from this repo.
  81. 2. Open your browser's extensions page, for example `chrome://extensions`.
  82. 3. Enable Developer Mode.
  83. 4. Click Load unpacked.
  84. 5. Select the `extension/` directory.
  85. ### 3. Connect The Extension
  86. With the Kept app running, open this page in the same browser:
  87. ```
  88. http://localhost:18241/connect
  89. ```
  90. That page gives the extension its per-install token. After that, use the extension popup or Kept onboarding flow to sync your providers.
  91. ## Vault Layout
  92. Kept writes conversations as Markdown with YAML frontmatter:
  93. ```
  94. ~/.kept/vault/
  95. chatgpt/
  96. 2026-05-02_optimizing-cuda-kernel.md
  97. claude/
  98. 2026-05-02_kept-readme-draft.md
  99. gemini/
  100. grok/
  101. kimi/
  102. ```
  103. 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.
  104. ## MCP Server
  105. `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.
  106. Inside Claude Code:
  107. ```text
  108. /plugin marketplace add egroup-labs/kept.work
  109. /plugin install kept-vault@kept-plugins
  110. ```
  111. One-line installer for Linux and macOS:
  112. ```bash
  113. bash <(curl -fsSL https://raw.githubusercontent.com/egroup-labs/kept.work/main/scripts/install-kept-mcp.sh)
    • Note: Runs a downloaded script through process substitution (bash <(curl …))
    • Line 169 on GitHub
  114. ```
  115. PowerShell:
  116. ```powershell
  117. & ([scriptblock]::Create((irm https://raw.githubusercontent.com/egroup-labs/kept.work/main/scripts/install-kept-mcp.ps1)))
  118. ```
  119. Set `KEPT_VAULT_PATH` if your vault is not at `~/.kept/vault`.
  120. Tools exposed by the server:
  121. - `list_vault`
  122. - `list_directory`
  123. - `read_file`
  124. - `write_file`
  125. - `update_file`
  126. - `delete_file`
  127. - `move_file`
  128. - `grep_vault`
  129. ## Build From Source
  130. Requirements:
  131. - Node.js 20+
  132. - Rust toolchain
  133. - A Chromium-based browser
  134. - Optional: [Ollama](https://ollama.com/) for local models and embeddings
  135. ```bash
  136. git clone https://github.com/egroup-labs/kept.git
  137. cd kept/app
  138. npm ci
  139. npm run tauri dev
  140. ```
  141. ### Linux Dependencies
  142. Ubuntu/Debian:
  143. ```bash
  144. sudo apt install -y \
  145. build-essential clang libclang-dev pkg-config \
  146. libgtk-3-dev libwebkit2gtk-4.1-dev libsoup-3.0-dev \
  147. libpango1.0-dev libcairo2-dev libgdk-pixbuf-2.0-dev libglib2.0-dev
  148. ```
  149. `build-essential`, `clang`, and `libclang-dev` are required for Rust crates that
  150. use `bindgen` (e.g. `zstd-sys` pulled in by CozoDB). The rest are the GTK /
  151. WebKitGTK / GLib stack Tauri 2 links against.
  152. Then run:
  153. ```bash
  154. npm run tauri:dev:linux
  155. ```
  156. ### Frontend-Only Mode
  157. You can run the UI against mock data without the Rust app:
  158. ```bash
  159. cd app
  160. npm ci
  161. npm run dev
  162. ```
  163. Vite serves the UI at `http://localhost:1420`.
  164. ## Repository Layout
  165. ```
  166. app/ Tauri 2 desktop app
  167. src/ React frontend
  168. src-tauri/ Rust backend, Axum server, vault, search, graph, agent tools
  169. extension/ Chromium extension
  170. platforms/ Provider sync adapters
  171. mcp/ MCP server for the vault
  172. scripts/ App and MCP install scripts
  173. ```
  174. ## Privacy And Security
  175. - Core archive and search data stays on your machine in `~/.kept/`.
  176. - The extension talks to the desktop app over `localhost` and must include the bearer token stored at `~/.kept/token`.
  177. - Kept has no hosted account and no cloud sync.
  178. - Optional chat, topic discovery, and graph features call only the model provider you configure, or your local Ollama server.
  179. - The updater checks the configured Kept update endpoint for new desktop releases.
  180. ## Contributing
  181. Issues and pull requests are welcome. Conventional commits are preferred:
  182. ```text
  183. feat(scope): add ...
  184. fix(scope): repair ...
  185. ```
  186. Useful areas to start:
  187. - `extension/platforms/` for provider adapters
  188. - `app/src-tauri/src/vault.rs` for vault writes
  189. - `app/src-tauri/src/db.rs` for search indexing
  190. - `app/src-tauri/src/kg-gen/` for graph generation
  191. - `mcp/src/` for MCP vault tools
  192. ## License
  193. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.