KeepThread
30-Second Setup · Zero Cloud · Lossless Sync

KeepThread Quick Start Guide

Link your local Obsidian Vault once, sync conversations from ChatGPT, Gemini, Perplexity, DeepSeek, Grok, Kimi, and GLM in one click—and edit your notes freely without ever losing your custom tags or [[backlinks]] on re-sync.

1. Get running in 30 seconds

1

Install & Pin Icon

Install KeepThread in Chrome or Microsoft Edge, click the top-right puzzle icon (Extensions), and pin KeepThread to your toolbar.

2

Link Obsidian Vault

Open the welcome screen (or Obsidian Vault tab) and select your local Vault folder once. KeepThread uses the browser File System Access API—zero local server setup.

3

1-Click In-Place Sync

Open any chat on ChatGPT, Gemini, Perplexity, DeepSeek, Grok, Kimi, or GLM and click Sync to Vault (or press Alt+Shift+S). Existing tabs need one refresh after first install.

4

Search Offline Anytime

Press ⌘⇧K / Ctrl+Shift+K anywhere in your browser to search prompts, code blocks, and citations across all 7 AI platforms locally in IndexedDB.

2. See the difference: Before vs. KeepThread

Click a real-world scenario below to compare ordinary copy-paste / exporters with KeepThread's Obsidian-native output.

✕ Other Exporters on Re-Sync
1. Creates duplicate file:
   AI-Chats/deepseek/2026-11-19_Architecture (1).md

OR if it overwrites the file:
2. WIPES your handwritten ## My Notes
3. WIPES your [[Project Backlinks]]
4. WIPES your custom YAML properties & #tags
✓ KeepThread Lossless In-Place Merge
---
title: "Local-First Sync Architecture"
source: deepseek
updated: 2026-11-20T08:30:00.000Z
messages: 6
tags:
  - ai-chat
  - deepseek
  - project/keepthread   # <-- your tag preserved!
status: reviewed         # <-- custom YAML preserved!
project: "[[Roadmap]]"   # <-- wiki-link preserved!
---

<!-- keepthread:notes:start -->
## My Notes
- Core insight linked to [[PKM Architecture]]
<!-- keepthread:notes:end -->

<!-- keepthread:transcript:start -->
## Prompt ... (new turns merged cleanly!)
✕ Plain Copy-Paste from ChatGPT / Gemini
The attention score is computed as:
Attention(Q,K,V)=softmax(QKTdk)V
\text{Attention}(Q,K,V) = \text{softmax}\left(\frac{QK^T}{\sqrt{d_k}}\right)V
(Duplicated garbled Unicode + raw TeX breaks Obsidian!)
✓ KeepThread Obsidian-Ready Output
The attention score is computed as:

$$
\text{Attention}(Q,K,V) = \text{softmax}\left(\frac{QK^T}{\sqrt{d_k}}\right)V
$$

(Extracted directly from KaTeX/MathJax annotation — renders natively in Obsidian.)
✕ Plain Copy-Paste from Perplexity
IndexedDB natively stores FileSystemDirectoryHandle objects mdn+2 across browser restarts chrome+1.
(Clickable citation badges turn into unlinked text.)
✓ KeepThread Footnotes + Sources Section
IndexedDB natively stores `FileSystemDirectoryHandle` objects[^1] across browser restarts[^2].

---

## Sources

[^1]: [MDN — FileSystemDirectoryHandle](https://developer.mozilla.org/...)
[^2]: [Chrome Developers — File System Access API](https://developer.chrome.com/...)
✕ Plain Copy-Paste from DeepSeek-R1
Thought for 14 seconds
Wait, let me compare SQLite WASM vs IndexedDB first... Hmm, OPFS handles work differently...
Actually, pick IndexedDB because...
(Long reasoning chain clutters your note body.)
✓ KeepThread Collapsible Obsidian Callout
## Response

> [!note]- Thinking Process
> Compare SQLite WASM vs IndexedDB for MV3...
> IndexedDB natively stores directory handles.

Pick **IndexedDB** because it persists `FileSystemDirectoryHandle` with zero WASM overhead.

3. How Lossless Sync protects your Obsidian notes

Edit your AI notes freely in Obsidian — re-syncing never destroys your work

Every note synced to your Vault includes invisible HTML markers (completely hidden in Obsidian Live Preview & Reading view). Whenever you continue a chat and click Update Obsidian Note In-Place, KeepThread reads your existing local file first and performs a lossless merge:

4. Shortcuts & Custom Path Templates

Shortcut / Token What it does Example
⌘⇧K / Ctrl+Shift+K Open KeepThread local cross-platform offline search Search all 7 AI platforms instantly
Alt+Shift+S Quick-sync the active AI conversation tab Saves & opens Vault sync bar
{platform}, {year}, {month}, {day} Vault subfolder path template tokens (Pro) AI-Chats/{platform}/{year}-{month}
{date}, {slug}, {platform}, {id} Filename template tokens (Pro) {date}_{slug}.md

5. Frequently Asked Questions

How can I verify KeepThread really has zero cloud servers?

Open Chrome/Edge DevTools → Network tab while syncing a conversation. Zero bytes leave your machine during extraction, Markdown conversion, local search, or Obsidian Vault file writes. The only optional outbound request is Pro license key verification directly with live.dodopayments.com—which never includes any chat text or URLs.

Why does Chrome ask for one click to re-grant Vault write permission after a browser restart?

That is a built-in Chromium security rule for the File System Access API: directory handles are saved permanently in IndexedDB, and after a full browser restart Chrome asks for one click ("Allow edit") before writing to disk again. Within the same browser session, every sync is completely 1-click.

What happens if ChatGPT, Gemini, Perplexity, DeepSeek, Grok, Kimi, or GLM updates its page layout?

Open the License & Privacy tab inside KeepThread and click Copy DOM Outline. It generates a sanitized HTML tag skeleton containing zero chat text that you can email to support@jianlanzhiwei.com so we can ship an adapter patch rapidly.

How does the 3-device Lifetime Pro license work?

Pay once ($19 Early Bird via Dodo Payments) and receive a license key instantly by email. Activate it on up to 3 browsers/machines (for example: work Mac, personal laptop, and Edge). You can deactivate any device anytime inside KeepThread to free up its slot.

Ready to own your AI research forever?

Free forever for single-thread Markdown exports + 5 free Lossless Vault syncs. Upgrade once ($19) for unlimited Vault sync & offline search.

Add to Chrome (Free) Add to Edge Get Lifetime Pro ($19)