Let an AI agent read the latest messages in a WeChat chat as JSON or Markdown.
Have an agent send a WeChat reply once a human approves the text.
Watch a specific WeChat conversation and get notified as new messages arrive.
Plug UseChat into a custom agent runtime as a stdio tool so it can read and write messages programmatically.
| cosmosshadow/usechat | hotakus/opencode-visual-cache | imgoodbai/mapgogogo | |
|---|---|---|---|
| Stars | 37 | 37 | 37 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | hard | easy | moderate |
| Complexity | 4/5 | 2/5 | 3/5 |
| Audience | developer | developer | general |
Figures from each repo's GitHub metadata at analysis time.
Requires installing a separate Helper app, granting OS-level screen and input permissions, and configuring a vision-capable API key.
UseChat is a tool that lets an AI agent, like Claude Code, Cursor, Codex, or OpenCode, operate the WeChat desktop app on your own computer, the same way a person would sit in front of it. It does this by taking screenshots of the WeChat window, reading the text with OCR, and understanding the layout, then turning all of that into commands the agent can read, write, and check. It does not break into WeChat's private protocols, does not inject code into the client, does not read your local chat database, and does not take over your account. Everything happens through screenshots, mouse clicks, keyboard input, and clipboard actions that the operating system already allows. The first supported app is WeChat's desktop client, on both macOS and Windows. With the command line tool, you can read the messages currently visible in a chat, send text, files, images, or videos, and watch a conversation for new messages as they arrive, with results shown as readable text or as JSON for machines. There is also a serve mode that keeps a steady connection open so an external agent runtime can send read and write requests to it directly. Reading messages requires a vision capable AI model, since the tool has to look at a screenshot and turn it into a structured list of messages. Sending messages does not use a model at all. Setup involves installing the command line package through npm, plus a separate Helper program that actually handles the screen capture, clicks, and OCR on your machine, since the Helper is not installed automatically with the main package. UseChat comes from a company called Shennian, which built a broader WeChat automation and multi agent control product, this project is the local connector piece they open sourced separately. The tool includes built in checks, a doctor command, to confirm the Helper is installed, permissions are granted, and WeChat is logged in, along with diagnostic logs that avoid saving raw screenshots or full clipboard contents.
A local tool that lets an AI agent operate the WeChat desktop app on your computer through screenshots and OCR, without hacking protocols or reading your chat data.
Mainly TypeScript. The stack also includes TypeScript, Node.js, npm.
Setup difficulty is rated hard, with roughly 1h+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.