wx-cli

A command-line tool for querying chat history, contacts, sessions, favorites, and related data from a locally installed WeChat desktop database. It is invoked when a user mentions WeChat messages, message history, contacts, group members, group nicknames, or saved favorites, and it installs and drives the wx CLI to answer those requests. It runs on macOS (Apple Silicon or Intel) or Linux, requires WeChat desktop 4.x installed and logged in, and needs Node.js 14 or newer for npm installation or curl for the shell installer.

Setup is a one-time process. The tool installs via npm install of the wx-cli package or a curl-piped install script. On macOS the documented order is to re-sign WeChat with codesign, clear stale macOS TCC privacy authorizations with tccutil resets for services like ScreenCapture, Camera, and Microphone so new csreq records are regenerated, restart WeChat, and then run sudo wx init; on Linux it is simply sudo wx init. Initialization detects the WeChat data directory, scans process memory to extract database keys, and writes a config file under the home directory; after that, commands run without sudo and a daemon starts automatically on first use.

The command surface is broad and defaults to token-efficient YAML output with a json option. Session and message commands include sessions, unread with a filter for private, group, official, or folded, new-messages, history, and a full-database search, all carrying a chat_type field and supporting a limit for result counts. Contact and group commands list contacts and group members with stable identity fields like username, display, and group nickname. Moments commands cover interaction notifications, a cached feed, and full-text search, while biz-articles reads official-account article pushes from separate database shards. Attachment commands list image attachments and extract and decrypt them, documenting legacy XOR, V1 fixed-AES, and V2 AES-plus-XOR decoder tiers, and a favorites command lists saved items. Output wrappers expose metadata and freshness statuses such as possibly stale to signal when results may be incomplete.