WeChat ACP: messaging bridge for Hermes Agent

Bridge that forwards WeChat direct messages to any ACP-compatible agent, with a built-in Hermes preset

What WeChat ACP does

wechat-acp logs in with a WeChat QR code rendered in the terminal, polls incoming one-to-one messages, forwards them to an ACP agent over stdio, and sends the agent's reply back to WeChat. Each WeChat user gets one ACP agent session. Group chats are ignored, and the login token is saved under ~/.wechat-acp.

Built-in presets cover copilot, claude, gemini, qwen, codex, opencode, openclaw, kiro, hermes, kimi and pi, and a raw custom command can be passed instead. Images, audio, embedded resources and generated files from the agent are delivered to WeChat. Options include a background daemon mode, named instances, idle timeouts, a session-resume policy and flags to hide thoughts, diffs or images. Every push to main is published to npm under the next dist-tag for trying preview builds.

Key features

WeChat QR login with terminal QR rendering
One ACP agent session per WeChat user
Built-in agent presets including hermes
Agent images, audio and files delivered as native WeChat messages
Background daemon mode and named, isolated instances
Auto-allows permission requests from the agent

When to use it

Chatting with Hermes Agent from a WeChat direct message
Switching the same bridge between several ACP agents by preset name
Running the bridge as a background daemon on a server

Who it is for: Developers who want to reach an ACP-compatible coding or assistant agent through WeChat.

How it fits with Hermes Agent

Supports Hermes Agent as one of eleven built-in agent presets. It is a general ACP bridge and is not built only for Hermes Agent.

How to install WeChat ACP

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

npx -y wechat-acp@latest --agent copilot
npx wechat-acp agents

Requirements: Node.js 20+, a WeChat environment that can use the iLink bot API, and an ACP-compatible agent available locally or through npx

FAQ

What is WeChat ACP?

WeChat ACP is a bridge that connects WeChat direct messages to any ACP-compatible AI agent. It forwards each message to the agent over stdio and sends the reply back to WeChat.

Does WeChat ACP work with Hermes Agent?

Yes, hermes is one of the built-in presets, selected with the --agent option. Run npx wechat-acp agents to list the bundled presets.

What do I need to run WeChat ACP?

You need Node.js 20+, a WeChat environment that can use the iLink bot API, and an ACP-compatible agent available locally or through npx. The first run starts a QR login in the terminal.