freestylefly

freestylefly / wechat-cli

Public

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

wesight.ai agent c-li claude claude-code openc
183
135
69% credibility
Found Apr 08, 2026 at 184 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A desktop tool for searching, exporting, and analyzing local WeChat chat messages, contacts, sessions, and favorites in a format friendly for AI use.

How It Works

1
🕵️ Discover chat searcher

You hear about a handy tool that lets you easily search and review your WeChat conversations without digging through the app.

2
📥 Set up the helper

Download the simple program to your computer and get it ready to use.

3
🔓 Unlock your chats

With WeChat running, do a one-time setup to safely access your personal message data.

4
👥 See recent talks

Check your latest conversations and see who's messaged you lately.

5
💬 Read chat history

Pick a friend or group and pull up their recent messages with dates and details.

6
🔍 Search anything

Find exact words or topics across all your chats, even in old groups.

7
📤 Export or share

Save chat logs as readable files or neat lists to review or feed to an AI buddy.

🎉 Chats at your fingertips

Now you can quickly revisit memories, analyze talks, or answer questions about your WeChat history anytime.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 184 to 183 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, letting you query chat history, contacts, recent sessions, unread messages, group members, favorites, and stats via simple commands like `wechat-cli history "friend" --limit 50` or `wechat-cli search "keyword"`. It solves the problem of accessing WeChat's encrypted SQLite databases without official APIs, outputting clean JSON or text perfect for piping into LLMs or scripts. Cross-platform binaries make it a drop-in cli tool for Windows, Linux, and Mac—download via cli github com packages or build with PyInstaller.

Why is it gaining traction?

Unlike web scrapers or unofficial APIs that risk bans, it reads your local data directly after a one-time key extraction, with incremental `new-messages` for real-time feeds and export to Markdown for analysis. LLM integration shines: JSON outputs include timestamps, senders, and media paths, ideal for RAG or agents. Features like chat stats (hourly activity, top senders) and fuzzy contact search beat basic dump tools, drawing devs from cli tools ai and cli tools github crowds.

Who should use this?

AI engineers building WeChat-powered chatbots or LLM agents needing conversation context. Data analysts reviewing personal/group chat patterns on cli github ubuntu or cli tools windows. Devs prototyping cli tools linux/mac integrations, like feeding history into GitHub Copilot extensions or local LLMs.

Verdict

Solid for niche WeChat data needs—grab it if you're in that boat, especially with prebuilt binaries easing cli github clone/deploy. At 183 stars and 0.7% credibility score, it's early-stage with thin docs and no tests, so expect tweaks for production; test on a backup first.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.