pandorafuture/wx-cli

WeChat on macOS stores your messages in encrypted databases on your own device. This command-line tool, written in Rust, decrypts those databases and lets you search and export your own chat history. It targets WeChat versions 4.1.7.x and 4.1.8.x on Apple Silicon Macs. The first step is extracting the encryption key. The tool does this by attaching a debugger (LLDB) to the running WeChat process and intercepting the moment WeChat reads its own key from the system keychain. This method requires disabling macOS System Integrity Protection, because the operating system normally blocks one process from inspecting another this deeply, even with administrator access. If you already have the key from another source, you can enter it manually and skip that requirement entirely. Once the key is obtained, the tool decrypts the database files into a local cache. From there you can run queries through a set of subcommands: listing recent conversations, searching contacts by name, reading messages from a specific person or group, doing a full-text search across all chats, or watching for new messages in real time. The tool can also decrypt media files, including images stored in WeChat's proprietary format, voice messages, and video files. For programmatic access, the tool includes an optional HTTP server mode. When that server is running, the same query commands will automatically route through the REST API instead of reading the local files directly. All query commands support JSON output for piping into other tools. The README is written in Chinese and covers installation from prebuilt binaries or from source using the Rust toolchain, troubleshooting steps for common errors, a full command reference table, and configuration options including the ability to hide specific contacts from query results.