huohuoer

huohuoer / wechat-cli

Public

A CLI tool to query your local WeChat data β€” chat history, contacts, sessions, favorites, and more. Designed for LLM integration.

69
500
69% credibility
Found Apr 14, 2026 at 68 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
AI Summary

A tool for accessing, searching, and exporting personal WeChat chat data including messages, contacts, sessions, and favorites from local storage.

How It Works

1
πŸ” Discover chat explorer

You learn about a helpful tool that lets you easily search and review your old WeChat conversations without endless scrolling.

2
πŸ“₯ Set up the tool

Download the program to your computer and make sure WeChat is running in the background.

3
πŸ”“ Unlock your history

Run a quick preparation step that safely accesses your personal WeChat data so everything becomes readable.

4
πŸ“± See recent chats

Check your latest conversations, unread messages, and who's messaged you recently.

5
Find what you need
πŸ’¬
Search messages

Look up keywords in specific chats or across all your history.

πŸ‘₯
List contacts

Browse friends, groups, or get details on anyone.

πŸ“Š
Check stats

See message counts, active times, or top chatters.

6
πŸ’Ύ Export conversations

Save chat histories as readable files to review or share anytime.

πŸŽ‰ Master your chats

Now you effortlessly find, organize, and relive any WeChat moment you want.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 68 to 69 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is wechat-cli?

wechat-cli is a Python CLI tool that unlocks your local WeChat dataβ€”chat histories, contacts, sessions, unread counts, favorites, group members, and statsβ€”by decrypting databases on-demand. Run `wechat-cli init` once to pull keys from running processes, then query with `history "friend" --limit 50`, `search "keyword" --chat "group"`, `new-messages`, or `export "chat" --format markdown` for JSON/text output tuned for LLM pipelines. Cross-platform binaries make it a snap on cli github linux, cli github ubuntu, cli github windows, or cli tools mac via cli github com packages or direct download cli tool.

Why is it gaining traction?

It bridges WeChat's locked SQLite DBs to AI workflows without APIs or cloud scraping, delivering time-range searches, pagination, media paths, and incremental polling that cli tools ai users demand. Prebuilt executables via cli github actions beat manual Python setups, while LLM-friendly JSON keeps prompts clean. Niche focus on structured exports (stats, unread diffs) edges out basic chat dumpers.

Who should use this?

AI devs feeding WeChat chats into RAG/agents on cli tools github or cli github copilot setups. Data analysts tracking group dynamics or favorites via cli tool python scripts. Offline toolers on cli tools linux/macos needing quick `sessions` lists or `stats "group"`.

Verdict

Grab it for WeChat+LLM hacks (0.70% credibility score)β€”37 stars mean it's raw but functional, with solid bilingual docs; lacks tests, so verify your data dir first. Worth a cli github clone if it fits; otherwise, pass. (187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.