whatisgithub

What is wechat-radar?

zjp1997720/wechat-radar — explained in plain English

Analysis updated 2026-05-18

67Audience · generalComplexity · 3/5LicenseSetup · moderate

In one sentence

A local-first dashboard that reads your Mac's WeChat data and turns busy group chats into a daily briefing of topics, shared links, and mentions.

Mindmap

mindmap
  root((WeChat Radar))
    What it does
      Local WeChat dashboard
      Daily briefings
      Topic clustering
    Tech stack
      Next.js
      ECharts
      better sqlite3
    Use cases
      Track many group chats
      Summarize mentions
    Audience
      Heavy WeChat users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get a daily summary of what was discussed across many WeChat groups without scrolling history.

USE CASE 2

See deduplicated shared links and messages that mention you in one place.

USE CASE 3

Generate a per-group report you can paste into an AI assistant for further summarizing.

What is it built with?

Next.jsEChartsbetter-sqlite3

How does it compare?

zjp1997720/wechat-radaraichovy/vibe-observerassyoucandy/telemt-server-guide
Stars676767
LanguageRustHTML
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencegeneraldeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires macOS with WeChat 4.x logged in and a separate wx-cli tool to read local chat data.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

WeChat Radar is a local-first dashboard for people who are members of many WeChat group chats and find it hard to keep up with what matters. Instead of scrolling through a long message history, the app reads your local WeChat data on your Mac and turns it into a daily briefing: what was discussed today, which links were shared (deduplicated and given readable titles), messages where you were mentioned, and a summary report for each active group. The app runs entirely on your own computer. Chat data is stored in a local SQLite database file under a folder in your home directory, and nothing is sent to a third-party service. The README includes a clear privacy note: using this tool is your responsibility in terms of complying with WeChat's client rules, local laws, and the privacy expectations of the people in your groups. One feature is a topic radar that clusters messages from across all your groups by theme for a given day. This is powered by OpenAI's Codex CLI (a separate tool) if you have it installed, without it the dashboard still works but topic grouping is less sophisticated. The per-group daily report is designed to be copied and pasted into an AI assistant for further processing, such as drafting replies or summarizing discussions. The setup requires macOS with WeChat 4.x already logged in, plus a separate command-line tool called wx-cli that handles reading the local WeChat data. You also need Node.js 20 or newer and the pnpm package manager. After a one-time setup step at /setup in the browser, you select a date range and click rescan to pull in messages. A demo mode is available if you want to try the interface without connecting to real chat data. The project is licensed under MIT and is built with Next.js, ECharts (for charts), and better-sqlite3.

Copy-paste prompts

Prompt 1
Help me set up wx-cli and WeChat Radar to read my local WeChat chat history on Mac.
Prompt 2
Show me how WeChat Radar's topic clustering works with and without Codex CLI installed.
Prompt 3
Walk me through the one-time setup step and running my first rescan.
Prompt 4
Explain what data WeChat Radar stores locally and what privacy responsibilities I have.

Frequently asked questions

What is wechat-radar?

A local-first dashboard that reads your Mac's WeChat data and turns busy group chats into a daily briefing of topics, shared links, and mentions.

What license does wechat-radar use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is wechat-radar to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is wechat-radar for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.