Guide · Open source
How to use WeChatPlugin-MacOS: install and use the WeChat helper
Updated · written with AI from the project's own documentation and checked against our catalogue data
WeChatPlugin-MacOS (微信小助手) is an open-source plugin for the macOS desktop version of WeChat that adds features the official app does not include, such as blocking message recalls, auto-reply, and running multiple WeChat logins. This guide explains what you need, how the Terminal install works, how to use the main features, and how to uninstall it. Because installation modifies the WeChat app, read the risks section before you start.
Quick start
- 1Check prerequisites. Confirm you have a Mac running macOS, the WeChat for macOS app, and Git installed.
- 2Open Terminal. Go to Applications, Utilities, then Terminal.
- 3Run the install command. Paste the README's one-line command and press Return. It clones the repo and runs Other/Install.sh.
- 4Restart WeChat. Quit and reopen WeChat so the plugin loads.
- 5Confirm the menu bar item. Check that 微信小助手 appears in the menu bar.
- 6Configure features. Open the feature windows with the shortcuts listed in the README, such as command + t for anti-recall.
What you need before installing WeChatPlugin-MacOS
The README lists three prerequisites: macOS, WeChat for macOS, and Git. The project targets macOS only, so it does not apply to Windows or Linux.
The README also notes that if you see a 'Permission denied' error during installation, you can run a chmod command on WeChat.app. Changing permissions on an application is a system-level change, so only do this if you understand what it does.
- macOS
- WeChat for macOS
- Git (the README's first install step says to install Git)
Install WeChatPlugin-MacOS with the Terminal command
The README's install method is to clone the repository and run its install script. Open Terminal from Applications, then Utilities, then Terminal (应用程序-实用工具-Terminal). Run the command below. It downloads the project into your Downloads folder and runs Other/Install.sh, which modifies the WeChat app.
After installation, restart WeChat. If the plugin is installed, you should see 微信小助手 in the menu bar. The README also describes a manual route: download the project as a ZIP from the 'clone or download' button, unzip it, and drag Install.sh (in the Other folder) into Terminal.
- Restart WeChat after installing.
- Look for 微信小助手 in the menu bar to confirm the install worked.
- The README points to Install.md in the repo for detailed install and rebuild steps.
cd ~/Downloads && rm -rf WeChatPlugin-MacOS && git clone https://github.com/TKkk-iOSer/WeChatPlugin-MacOS.git --depth=1 && ./WeChatPlugin-MacOS/Other/Install.shUse the main features: anti-recall, auto-reply and multi-login
Anti-recall: click 开启消息防撤回 in the plugin menu, or press command + t to turn it on or off. Auto-reply: click 开启自动回复 or press command + k to open its settings window. Multi-login: click 登录新微信 or press command + shift + n to open another WeChat login. Remote control: click 远程控制 Mac OS or press command + shift + c to open the control window.
The auto-reply rules in the README are specific. A keyword of * replies to every message. A keyword written as x|y replies to both x and y. Rules with an empty keyword or empty reply are not enabled. You can set a delay in seconds, and if you enable regex, the README recommends checking the expression with an online tester. If you enable replies for specific contacts, the earlier group and private chat replies stop working.
- Anti-recall: command + t
- Auto-reply: command + k; keyword * matches all messages
- Multi-login: command + shift + n
- Remote control: command + shift + c; only commands sent to your own account are accepted
Use remote control and Mac functions safely
The README lists remote-control commands that you can send via WeChat messages, including screen saver, emptying the Trash, locking, sleeping, shutting down or restarting the Mac, quitting selected apps, and controlling NetEase Cloud Music playback. It also says remote control only works when you send the command to your own account.
To control NetEase Cloud Music, the README says to add WeChat and Script Editor under System Preferences, Security & Privacy, Privacy, Accessibility.
- Screen saver, empty Trash, lock, sleep, shut down, restart
- Quit QQ, WeChat, Chrome, Safari or all programs
- NetEase Cloud Music: play, pause, next, previous, like, unlike
- Plugin commands: get command list, toggle anti-recall, auto-reply, and no-auth login
Uninstall WeChatPlugin-MacOS
The README describes uninstalling by opening Terminal and dragging the Uninstall.sh file (in the Other folder of the unzipped project) into the window, then pressing Return. Make sure you still have the project folder, since the script lives inside it.
Understand the risks before you install
The README's disclaimer says using plugins carries risk and should be approached with caution. The project states it is meant for improving everyday convenience and not for commercial or other uses, and that users bear responsibility if it is misused. Installation changes WeChat.app, so if you want the official app left untouched, do not install this plugin.
The README's badges show support up to WeChat 2.3.22, and the changelog lists a later entry for WeChat 3.7.0. The repository's last push was in June 2024. Check the release notes and open issues before relying on any feature.
- The install script modifies WeChat.app.
- The README warns that plugins carry risk.
- Support status and features may not match your current WeChat version; verify before relying on them.
What people use it for
- Keep a message visible after the sender recalls it, using the anti-recall toggle.
- Set up keyword-based auto-replies with optional delays in group and private chats.
- Run a second WeChat login on the same Mac with the multi-login shortcut.
- Send commands from WeChat to your own account to lock the screen or control music playback.
Frequently asked questions
Is WeChatPlugin-MacOS free?
The repository is licensed under the MIT License, as shown in the project's license badge. The README does not mention pricing for the plugin.
What do I need to install WeChatPlugin-MacOS?
The README lists macOS, WeChat for macOS, and Git as prerequisites. Installation runs from Terminal using a clone-and-build style command.
Does WeChatPlugin-MacOS work on Windows?
No. The project targets macOS only, so Windows and Linux users are not supported.
Is it safe to install WeChatPlugin-MacOS?
The README warns that using plugins carries risk and the install script modifies WeChat.app. Only install it if you accept that the official app will be changed.
How do I uninstall WeChatPlugin-MacOS?
Open Terminal, drag the Uninstall.sh file from the Other folder of the project into the window, and press Return, as the README describes.
Does it work with the latest WeChat version?
The README badges list support up to WeChat 2.3.22, and the changelog mentions 3.7.0. The last push was in June 2024, so check the current release notes before installing.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
WeChatPlugin-MacOS suits Mac users who already rely on WeChat desktop, are comfortable running Terminal commands, and want features like anti-recall, auto-reply or multiple logins. It is a poor fit if you want to leave WeChat.app unmodified, use Windows or Linux, or need an officially maintained tool given its last push in June 2024.
Install options & downloads