#3715 [Open Source] ChatDrop: Query WeChat exports from AI tools

Project URL

Project Title

ChatDrop: Query WeChat exports from AI tools

Project Description

A Mac share extension and Python CLI that organize selected WeChat exports in SQLite. Query conversations and dates from AI coding tools, reuse matching messages, and fill missing attachments from later exports. MIT licensed.

Highlights

Maintainer self-submission. This is an early release with a downloadable Apple Silicon Mac app, Chinese-first documentation, English documentation, synthetic fixtures, and CI.

Receives WeChat's native shared ZIPs through a Swift macOS share extension. Users choose a local conversation name instead of relying on unavailable native group IDs.
The Python CLI uses the standard library and returns JSON, context and local attachment paths. It can be used by existing Codex, Claude Code or other agent sessions with shell access.
Separates canonical messages from import provenance. A later export can supply a missing video without adding another copy of the matched message. Original files remain available for verification.
Useful as a small example of connecting a native sharing extension, file receipts, SQLite and an agent-friendly CLI.

Current scope: Apple Silicon Mac; Python 3.9+ for the CLI. Same-minute identical messages exported separately can be ambiguous because matching is not based on WeChat message IDs. ChatDrop itself does not upload chats; external AI tools have their own data handling.

I checked the repository URL in the HelloGitHub website search and searched existing GitHub submissions before submitting; no matching result was visible.

Example Code

chatdrop conversations
chatdrop search --conversation 'Product group' --from 2026-09-01 --to 2026-09-16 --all
chatdrop context '<message-id>' --radius 3

Screenshots or Demo Videos

Real native app screenshot:

AI-generated sharing illustration with fictional conversation names:

Download and setup: https://github.com/Daily-AC/chatdrop/releases/latest