ChatMemoryBridge

Universal Chat History Extractor — Extract your conversations from 8+ AI web platforms and import into any agent memory system
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
2. Architecture
3. Supported Platforms
4. Getting Started
5. Usage
6. Adding a New Platform
7. Roadmap
8. Contributing
9. License
10. Contact

About The Project

Your AI conversations across Kimi, ChatGPT, DeepSeek, Claude, and other platforms are a goldmine of context. But no agent has access to them — until now.

ChatMemoryBridge extracts your full chat history from any web AI platform using browser automation (Camofox), and formats it for ingestion into any agent memory system (Hermes, OpenClaw, and more).

How it differs from alternatives:

• 🔌 Multi-platform — 8+ platforms, not just one
• 🧠 Agent-aware — Output formatted for Hermes/OpenClaw memory, not just raw JSON
• 🔒 Your data stays local — No cloud, no SaaS. Browser runs on your machine
• 🚀 One-click install — curl | bash and you're done

(back to top)

Built With

• 
• 
• 

Architecture

                    ┌──────────────────────────────────────┐
                    │       Camofox Browser (:9377)        │
                    │  (stealth headless Firefox engine)   │
                    └──────┬──────┬──────┬──────┬──────────┘
                           │      │      │      │
              ┌────────────┘      │      │      └────────────┐
              ▼                   ▼      ▼                   ▼
      ┌──────────────┐   ┌──────────┐ ┌──────────┐   ┌──────────────┐
      │   kimi.com   │   │ chatgpt  │ │ deepseek │   │  claude.ai   │
      │  (✅ Ready)  │   │ (🚧 WIP) │ │ (🚧 WIP) │   │  (🚧 WIP)    │
      └──────┬───────┘   └──────────┘ └──────────┘   └──────────────┘
             │
             ▼
      ┌──────────────────────────────────────────────────┐
      │           chat_history.jsonl + markdown          │
      │         (platform-agnostic intermediate)         │
      └──────────┬───────────────────────┬───────────────┘
                 ▼                       ▼
      ┌─────────────────┐     ┌──────────────────────┐
      │  Hermes Memory  │     │  OpenClaw Memory     │
      │  (via skill)    │     │  (via plugin)        │
      └─────────────────┘     └──────────────────────┘

Flow:

1. One-time login per platform (visible browser, you log in manually)
2. Session cookies saved locally
3. Automated extraction (headless browser, uses saved cookies)
4. Conversations saved as JSONL + markdown digest
5. Ingest into Hermes/OpenClaw memory

(back to top)

Supported Platforms

Platform	Status	Method	Auth
Kimi (月之暗面)	✅ Ready	Camofox browser	Cookie (manual once)
ChatGPT (OpenAI)	🚧 In Progress	Camofox browser	Cookie / OAuth
DeepSeek Chat	🚧 In Progress	Camofox browser	Cookie
Claude (Anthropic)	🚧 In Progress	Camofox browser	Cookie / OAuth
Google Gemini	🚧 In Progress	Camofox browser	Google OAuth
智谱清言 (Zhipu)	🚧 Planned	Camofox browser	Cookie / SMS
豆包 (ByteDance)	🚧 Planned	Camofox browser	Cookie / Douyin
文心一言 (Baidu)	🚧 Planned	Camofox browser	Cookie / Baidu

Adding a new platform? See Adding a New Platform. It takes ~50 lines of Python.

(back to top)

Getting Started

Prerequisites

• Camofox browser running on localhost:9377

  # Check if running
  curl http://localhost:9377/health

• Python 3.8+

Installation

Option 1: One-click install (recommended)

curl -fsSL https://raw.githubusercontent.com/pixie-muon/chat-memory-bridge/main/install.sh | bash

Option 2: Manual install

git clone https://github.com/pixie-muon/chat-memory-bridge.git
cd chat-memory-bridge
pip install -r requirements.txt

(back to top)

Usage

1. List available platforms

cmb list

2. Login (one-time per platform)

cmb login kimi

This opens a visible browser. You log in manually (QR code / SMS / password). Type done when finished — cookies are saved to ~/.chat-memory-bridge/cookies_kimi.json.

3. Extract conversations

cmb extract kimi --limit 20

Uses saved cookies, opens headless browser, extracts all conversations.

Output:

• output/kimi_*.jsonl — Raw JSONL for programmatic use
• output/digest/*.md — Markdown files for human reading

4. Ingest into agent memory

# Hermes
hermes chat -q "Read ~/.chat-memory-bridge/output/digest/*.md and save to my memory"

# Or install the Hermes skill
hermes skills install ~/.chat-memory-bridge/integrations/hermes/SKILL.md

(back to top)

Adding a New Platform

Adding a new AI platform takes ~50 lines of Python:

from src.platform import Platform, PlatformRegistry

class MyPlatform(Platform):
    name = "My AI Platform"
    domains = ["my-ai.com"]
    status = "✅ Ready"
    auth_method = "Cookie"

    def login_url(self): return "https://my-ai.com/login"
    def chat_history_url(self): return "https://my-ai.com/chats"
    def check_login(self, snap): return "log in" not in snap.lower()
    def extract_chat_list(self, browser, tab_id): ...
    def extract_conversation(self, browser, tab_id): ...

PlatformRegistry.register(MyPlatform)

Save to src/extractors/my_platform.py. It's auto-discovered.

(back to top)

Roadmap

• Core engine + Camofox integration
• Kimi.com extractor
• ChatGPT extractor
• DeepSeek extractor
• Claude extractor
• Google Gemini extractor
• 智谱清言 extractor
• 豆包 extractor
• 文心一言 extractor
• OpenClaw plugin (published)
• Hermes skill (published to skills hub)
• PyPI package (pip install chat-memory-bridge)
• Docker image (browser included)
• GitHub Actions CI for platform tests

(back to top)

Contributing

Contributions are what make the open source community amazing. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'feat: add AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Priority contributions: New platform extractors! See Adding a New Platform.

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

MUON | 默川 — @ToussaintKnight

Project Link: https://github.com/pixie-muon/chat-memory-bridge

(back to top)