wechat-bridge-opencode 0.1.2 → 0.1.4

package/README.md

@@ -1,243 +1,98 @@
 # WeChat OpenCode
 
-Bridge WeChat direct messages to opencode.
+Bridge WeChat direct messages to OpenCode.
 
-`wechat-bridge-opencode` (aka `wbo`) logs in with the WeChat iLink bot API, polls incoming 1:1 messages, forwards them to opencode over stdio, and sends the agent reply back to WeChat.
-
-<img src="./resources/screenshot.jpg" alt="wbo screenshot" width="400" />
+<img src="./resources/screenshot.jpg" alt="wechat-bridge-opencode screenshot" width="400" />
 
 ## 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
-- File sending: agent can send files/images back to WeChat via the `send-wechat` tool
-- Automatic model config forwarding for opencode agents
-
-## Requirements
-
-- Node.js 20+
-- A WeChat environment that can use the iLink bot API
-- [OpenCode](https://github.com/anomalyco/opencode) installed locally or via `npx`
+- **Text** — Send/receive messages between WeChat and OpenCode
+- **Images** — Send/receive images with WeChat CDN support
+- **Files** — Send/receive files of any type
+- **Audio/Video** — Full audio and video message support
+- **QR Login** — Terminal QR code rendering for WeChat login
+- **One Session Per User** — Dedicated ACP session for each WeChat user
+- **Daemon Mode** — Run in background with `--daemon`
+- **send-wechat Tool** — Agents can send files/images back to WeChat
 
-## Installation
+## Install
 
 ```bash
-npx wbo --agent opencode
+npx wechat-bridge-opencode --agent opencode
 ```
 
-That's it — `wbo` will be available globally after first run, and the `send-wechat` tool is automatically installed to `~/.config/opencode/tools/send-wechat.ts`.
-
-To install globally:
+Or install globally:
 
 ```bash
 npm install -g wechat-bridge-opencode
-```
-
-## Quick Start
-
-> **Important**: Run the bridge from your **working directory** (e.g. your project folder), **not** from an arbitrary install directory. Running from the install directory may cause conflicts.
-
-```bash
-cd /path/to/your/workdir
 wbo --agent opencode
 ```
 
-Or with a custom agent command:
+## Usage
 
 ```bash
-wbo --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-bridge-opencode`
-4. Begin polling direct messages
-
-## Built-in Agent Presets
-
-List the bundled presets:
-
-```bash
-wbo agents
-```
-
-Current presets:
-
-- `opencode`
-
-These presets resolve to concrete `command + args` pairs internally, so users do not need to type long `npx ...` commands.
-
-## CLI Usage
-
-```text
-wbo --agent <preset|command> [options]
-wbo agents
-wbo stop
-wbo status
-```
-
-Options:
-
-- `--agent <value>`: built-in preset name or raw agent command
-- `--cwd <dir>`: working directory for the agent process
-- `--login`: force QR re-login and replace the saved token
-- `--daemon`: run in background after startup
-- `--config <file>`: load JSON config file
-- `--idle-timeout <minutes>`: session idle timeout, default `1440` (use `0` for unlimited)
-- `--max-sessions <count>`: maximum concurrent user sessions, default `10`
-- `--show-thoughts`: forward agent thinking to WeChat (default: off)
-- `-h, --help`: show help
-
-Examples:
-
-```bash
-cd /path/to/your/workdir
-wbo --agent opencode
-wbo --agent opencode --cwd D:\code\project
-wbo --agent "npx opencode-ai acp"
-wbo --agent opencode --daemon
-```
-
-## Configuration File
-
-You can provide a JSON config file with `--config`.
-
-Example:
-
-```json
-{
-  "agent": {
-    "preset": "opencode",
-    "cwd": "D:/code/project"
-  },
-  "session": {
-    "idleTimeoutMs": 86400000,
-    "maxConcurrentUsers": 10
-  }
-}
+cd /path/to/your/project
+npx wechat-bridge-opencode --agent opencode
 ```
 
-You can also override or add agent presets:
-
-```json
-{
-  "agent": {
-    "preset": "my-agent"
-  },
-  "agents": {
-    "my-agent": {
-      "label": "My Agent",
-      "description": "Internal team agent",
-      "command": "npx",
-      "args": ["my-agent-cli", "--acp"]
-    }
-  }
-}
-```
+First run will:
+1. Show QR code in terminal
+2. Save login token to `~/.wechat-bridge-opencode`
+3. Start polling WeChat DMs
 
-## Runtime Behavior
+## Options
 
-- Each WeChat user gets a dedicated ACP session and subprocess.
-- Messages are processed serially per user.
-- Replies are formatted for WeChat before sending.
-- Typing indicators are sent when supported by the WeChat API.
-- Sessions are cleaned up after inactivity (set `idleTimeoutMs` to `0` to disable idle cleanup).
-- Switching workspace or session kills the old agent and spawns a new one immediately.
-- OpenCode session history is resumed via `unstable_resumeSession()` when switching to an existing session.
+| Flag | Description |
+|------|-------------|
+| `--agent <preset\|cmd>` | Built-in preset or raw command |
+| `--cwd <dir>` | Working directory |
+| `--login` | Force re-login |
+| `--daemon` | Run in background |
+| `--config <file>` | JSON config file |
+| `--idle-timeout <min>` | Session idle timeout (default: 1440, 0 = unlimited) |
+| `--max-sessions <count>` | Max concurrent sessions (default: 10) |
+| `--show-thoughts` | Forward agent thinking to WeChat |
 
 ## WeChat Commands
 
-Users can manage workspaces and sessions directly from WeChat:
-
 ### Workspace (`/workspace` or `/ws`)
 
 | Command | Description |
 |---------|-------------|
-| `/workspace list` | List all directories from OpenCode sessions |
-| `/workspace switch <n\|path>` | Switch to directory by index or path |
-| `/workspace add /path` | Add directory (creates if not exists) |
+| `/workspace list` | List all directories |
+| `/workspace switch <n\|path>` | Switch directory |
+| `/workspace add /path [name]` | Add directory |
 | `/workspace status` | Show current directory |
 
 ### Session (`/session` or `/s`)
 
 | Command | Description |
 |---------|-------------|
-| `/session list` | List recent 10 sessions with directory |
-| `/session switch <n\|slug>` | Switch to session by index or slug |
-| `/session new` | Restart session (clear context) |
-| `/session status` | Show current session info |
+| `/session list` | List recent 10 sessions |
+| `/session switch <n\|slug>` | Switch session |
+| `/session new` | New session (clear context) |
+| `/session status` | Show current session |
 
-### Help
+## Requirements
 
-| Command | Description |
-|---------|-------------|
-| `/help` | Show all available commands |
+- Node.js 20+
+- WeChat iLink bot API access
+- [OpenCode](https://github.com/anomalyco/opencode) installed locally or via npx
 
 ## Storage
 
-By default, runtime files are stored under:
+Runtime data stored in `~/.wechat-bridge-opencode`:
+- Login token
+- Auth tokens
+- Temp files (downloaded media)
+- Daemon PID / log
+- Bridge state (`.wechat-bridge-state.json`)
 
-```text
-~/.wechat-bridge-opencode
-```
-
-This directory is used for:
-
-- saved login token
-- auth tokens
-- tempfile (downloaded media)
-- daemon pid file
-- daemon log file
-- sync state
-- bridge state (`.wechat-bridge-state.json` — tracks last active user/session for the `send-wechat` tool)
-
-## Custom Tool: send-wechat
+## Notes
 
-The `send-wechat` tool is automatically installed to `~/.config/opencode/tools/send-wechat.ts`.
-
-This tool is available to opencode agents and lets them send files back to WeChat:
-
-```
-send-wechat(filePath: string)
-```
-
-The tool reads `~/.wechat-bridge-opencode/.wechat-bridge-state.json` to automatically determine the target user and session. The agent only needs to provide the file path.
-
-## Current Limitations
-
-- Direct messages only; group chats are ignored
+- Direct messages only (group chats ignored)
 - Permission requests are auto-approved
-- Some preset agents may require separate authentication before they can respond successfully
-
-## Development
-
-Clone and build locally:
-
-```bash
-git clone https://github.com/pan17/wechat-bridge-opencode.git
-cd wechat-bridge-opencode
-npm install
-npm run build
-```
-
-Run the CLI locally:
-
-```bash
-node dist/bin/wechat-opencode.js --help   # or simply: wbo --help
-```
-
-Watch mode:
-
-```bash
-npm run dev
-```
+- `send-wechat` tool auto-installed to `~/.config/opencode/tools/send-wechat.ts`
 
 ## License
 

package/dist/bin/wechat-opencode.js

@@ -21,18 +21,18 @@ function usage() {
         .map(({ id }) => id)
         .join(", ");
     console.log(`
-wechat-opencode — Bridge WeChat to any ACP-compatible AI agent
+wbo — Bridge WeChat to OpenCode
 
 Usage:
-  wechat-opencode --agent <preset|command>  [options]
-  wechat-opencode agents                        List built-in agent presets
-  wechat-opencode stop                          Stop a running daemon
-  wechat-opencode status                        Check daemon status
+  wbo --agent <preset|command>  [options]
+  wbo agents                        List built-in agent presets
+  wbo stop                          Stop a running daemon
+  wbo status                        Check daemon status
 
 Options:
   --agent <value>     Built-in preset name or raw agent command
                       Presets: ${presets}
-                      Examples: "copilot", "claude", "npx tsx ./agent.ts"
+                      Examples: "opencode"
   --cwd <dir>         Working directory for agent (default: current dir)
   --login             Force re-login (new QR code)
   --daemon            Run in background after login

package/dist/package.json

@@ -1,7 +1,7 @@
 {
     "name": "wechat-bridge-opencode",
-    "version": "0.1.2",
-    "description": "Bridge WeChat to any Opencode",
+    "version": "0.1.4",
+    "description": "Bridge WeChat to OpenCode",
     "type": "module",
     "files": [
         "dist/",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wechat-bridge-opencode",
-  "version": "0.1.2",
-  "description": "Bridge WeChat to any Opencode",
+  "version": "0.1.4",
+  "description": "Bridge WeChat to OpenCode",
   "type": "module",
   "files": [
     "dist/",