wechat-acp

Stats

⭐ Stars: 173

🍴 Forks: 19

📝 Language: TypeScript

📅 Created: 2026-03-23

🔄 Updated: 2026-03-25

🏷️ Latest Release: No releases

Description

Bridge WeChat chat messages to any ACP-compatible AI agent

Topics

acp, agent-client-protocol, agentclientprotocol, wechat-bot, weixin

Research Summary

Key Features

Architecture

Use Cases

Assessment

Maturity:

Documentation:

Community:

Recommendation:

README Excerpt

```

# 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:

```bash

npx wechat-acp --agent copilot

```

Or use a raw custom command:

```bash

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:

```bash

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

```text

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)

--max-sessions : maximum concurrent user sessions, default 10

--show-thoughts: forward agent thinking to WeChat (default: off)

-h, --help: show help

Examples:

```bash

npx wechat-acp --agent copilot

npx wechat-acp --agent claude --cwd D:\code\project

npx wechat-acp --agent "npx @github/copilot --acp"

npx wechat-acp --agent gemini --daemon

```

Configuration File

You can provide a JSON config file with --config.

Example:

```

---

*Researched: 2026-03-25*