Wechat Acp

WeChat ACP

Bridge WeChat direct messages to any ACP-compatible AI agent.

`wechat-acp` logs in with the WeChat iLink bot API, polls incoming 1:1 messages, forwards them to an ACP agent over stdio, and sends the agent reply back to WeChat.

Features

• WeChat QR login with terminal QR rendering
• One ACP agent session per WeChat user
• Built-in ACP agent presets for common CLIs
• Custom raw agent command support
• Auto-allow permission requests from the agent
• Direct message only; group chats are ignored
• Background daemon mode

Requirements

• Node.js 20+
• A WeChat environment that can use the iLink bot API
• An ACP-compatible agent available locally or through npx

Quick Start

Start with a built-in agent preset:

npx wechat-acp --agent copilot

Or use a raw custom command:

npx wechat-acp --agent "npx my-agent --acp"

On first run, the bridge will:

1. Start WeChat QR login
2. Render a QR code in the terminal
3. Save the login token under ~/.wechat-acp
4. Begin polling direct messages

Built-in Agent Presets

List the bundled presets:

npx wechat-acp agents

Current presets:

• copilot
• claude
• gemini
• qwen
• codex
• opencode

These presets resolve to concrete `command + args` pairs internally, so users do not need to type long `npx ...` commands.

CLI Usage

wechat-acp --agent  [options]
wechat-acp agents
wechat-acp stop
wechat-acp status

Options:

• --agent : built-in preset name or raw agent command
• --cwd : working directory for the agent process
• --login: force QR re-login and replace the saved token
• --daemon: run in background after startup
• --config : load JSON config file
• --idle-timeout : session idle timeout, default 1440 (use 0 for unlimited)