Pi WeChat Agent Bridge

A TypeScript tool that bridges WeChat messaging with Pi's AI coding agent, enabling natural language interaction with an AI coding assistant through WeChat.

中文版本

What is This?

WeChat Pi Bridge allows you to interact with Pi's AI coding agent directly from WeChat. This means you can:

• Send coding instructions and questions to the Pi agent
• Execute shell commands remotely
• Manage agent sessions (new session, switch models, compact history)
• All through familiar WeChat conversations

Quick Start

Installation

# Install globally for command-line usage
npm install -g wechat-pi

# Or run directly with npx
npx wechat-pi

Running the Bridge

# Start the bridge with default settings
wechat-pi

# Or development mode (directly from source)
pnpm dev

Authentication

1. Launch the bridge - it will display a QR code in the terminal
2. Open WeChat and scan the QR code
3. Once authenticated, you can start sending messages

Usage

Sending Messages

After authentication, simply send messages to interact with the Pi agent:

Regular Text Messages

Ask questions or give coding instructions:

• "How do I read a file in Python?"
• "Create a function that sorts an array"
• "What does this code do? [paste code]"

Shell Commands

Execute terminal commands (prefix with !):

!ls -la
!git status
!npm test

Special Commands

These commands control the bridge behavior:

| Command | Description | |---------|-------------| | /new | Start a fresh conversation session | | /model [name] | List available models or switch to a specific model | | /compact | Compact conversation history to reduce token usage | | /session | Show session information (file, ID, messages, tokens, model) | | /name [name] | Set or display the session name |

Command Line Options

wechat-pi [options]

Options:
  --no-session      Disable session persistence (in-memory only)
  --session-dir    Custom directory for session storage
  --work-dir       Working directory for the agent (default: current directory)
  --verbose        Enable verbose logging
  --logout         Clear WeChat credentials and exit
  --status         Show bridge status and exit
  --help           Show help information

Development

Prerequisites

• Node.js >= 16
• pnpm (recommended) or npm

Setup

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Run tests
pnpm test

# Build for production
pnpm build

# Run linter
pnpm lint

Project Structure

wechat-pi/
├── src/
│   ├── bridge.ts    # Main bridge logic
│   ├── cli.ts       # Command-line interface
│   └── types.ts     # TypeScript type definitions
├── dist/            # Compiled JavaScript
├── test/            # Test files
└── package.json    # Package configuration

How It Works

The bridge acts as a mediator between WeChat messages and the Pi agent:

[WeChat] <──> [WeChat Bot] <──> [Bridge] <──> [Pi Agent Session] <──> [AI Models]

1. Message Receiving: The WeChat bot receives messages from authenticated users
2. Command Processing: Special commands (/new, /model, !cmd) are handled directly
3. Agent Interaction: Regular messages are sent to the Pi agent session
4. Response Delivery: Assistant replies are sent back through WeChat

License

MIT © Jiajun Chen