wechat-cli 0.2.0

A CLI tool to interact with a Wechat iLink bot.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

---
name: wechat-cli
description: Use the `wechat-cli` command-line tool to log in a WeChat bot, manage accounts, and send text, image, or file messages to users.
---

# wechat-cli


## Install

```
cargo install wechat-cli
```

## Login


Use non-interactive login workflow:

1. Request a QR code:
   ```bash
   wechat-cli qrcode

   ```
2. Read `qrcode_id` and `qrcode_url` from the JSON output.
3. Show the QR code to the human outside the CLI.
4. Poll status:
   ```bash
   wechat-cli qrcode-status --qrcode-id <qrcode_id>
   ```
5. When `status` becomes `confirmed`, read `bot_token` and `user_id` from the JSON output.
6. Use `wechat-cli account add` to save those credentials.

## Account


### List Accounts


```bash
wechat-cli account list
```

Use this to find saved account indexes and inspect `user_id`.

### Add Account


```bash
wechat-cli account add \
  --user-id <user_id> \
  --bot-token <bot_token> \
  [--route-tag <route_tag>]
```

### Delete Account


By index:

```bash
wechat-cli account delete --account <index>
```

By user ID:

```bash
wechat-cli account delete --user-id <user_id>
```

## Send


### Prerequisites


Before sending, you need a `context_token`.

### Send Text


```bash
wechat-cli send \
  [--account <index> | --user-id <user_id>] \
  --context-token <token> \
  --text "hello"
```

### Send Image


```bash
wechat-cli send \
  [--account <index> | --user-id <user_id>] \
  --context-token <token> \
  --file <image_path>
```

### Send File


```bash
wechat-cli send \
  [--account <index> | --user-id <user_id>] \
  --context-token <token> \
  --file <file_path>
```

### Send With Caption


```bash
wechat-cli send \
  [--account <index> | --user-id <user_id>] \
  --context-token <token> \
  --file <file_path> \
  --caption "caption text"
```

### Explicit Credential Mode


Use this only when the task explicitly provides raw credentials instead of relying on saved accounts.

```bash
wechat-cli send \
  --bot-token <bot_token> \
  --user-id <user_id> \
  --context-token <token> \
  [--route-tag <route_tag>] \
  --text "hello"
```

## Important Rules


- The bot is bound to exactly one `user_id`.
- Re-login for the same WeChat user rotates the bound bot credentials.
- The bot can only send messages to its currently bound `user_id`.
- `--context-token` is always required for `send`.
- `--text` and `--file` are mutually exclusive.
- `--caption` only works with `--file`.

## Local Storage


- Storage root: `~/.config/wechat-cli/`
- Accounts file: `~/.config/wechat-cli/accounts.json`

## Help


Use built-in help before guessing flags:

```bash
wechat-cli --help
wechat-cli qrcode --help
wechat-cli qrcode-status --help
wechat-cli account --help
wechat-cli send --help
```