wechat-cli

A CLI tool to interact with a Wechat iLink bot.

Features

• Interactive QR code login for human
• Non-interactive QR code retrieval and status polling for agents
• Manage multi accounts
• Get context_token
• Send text, images, and files to WeChat users

Installation

cargo install wechat-cli

Usage

Usage: wechat-cli <COMMAND>

Commands:
  login              Log in with a QR code and save the account locally
  qrcode             Request a login QR code and print it as JSON without saving anything locally
  qrcode-status      Query a login QR code status and print it as JSON without saving anything locally
  account            Inspect saved accounts
  get-context-token  Wait for the next inbound message and print its context token
  send               Send a text, image, or file message
  help               Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print helpt-cli [COMMAND]

Login

Interactive QR code login:

wechat-cli login

Non-interactive QR code workflow for agents:

# Request a QR code
wechat-cli qrcode

# Poll QR code status
wechat-cli qrcode-status --qrcode-id <qrcode_id>

Account

List saved accounts:

wechat-cli account list

Add a new account:

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

Delete an account by index:

wechat-cli account delete --account <index>

Get Context Token

Wait for the next incoming message and print the context_token.

Using a saved account:

wechat-cli get-context-token --account <index>

Using explicit credentials:

wechat-cli get-context-token \
  --bot-token <bot_token> \
  --user-id <user_id> \
  [--route-tag <route_tag>]

Send

Send a text message using a saved account:

wechat-cli send \
  --account <index> \
  --context-token <token> \
  --text "hello"

Send text from stdin (pipe):

echo "hello from pipe" | wechat-cli send \
  --account <index> \
  --context-token <token>

Send text from a file via stdin redirection:

wechat-cli send \
  --account <index> \
  --context-token <token> \
  < message.txt

Send an image using a saved account:

wechat-cli send \
  --account <index> \
  --context-token <token> \
  --file ./image.png

Send a file with caption using a saved account:

wechat-cli send \
  --account <index> \
  --context-token <token> \
  --file ./image.png \
  --caption "this is an image"

Use explicit credentials (without saved account):

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

Message Source Priority

When sending, the CLI resolves the message source in this order:

1. If --text is provided, it is used regardless of stdin.
2. If --file is provided, it is used regardless of stdin.
3. If neither --text nor --file is provided, stdin is read when it is a pipe or redirected file.
4. If stdin is an interactive terminal and neither --text nor --file is provided, an error is returned.

Storage

Local files are stored under:

~/.config/wechat-cli/

Main file:

~/.config/wechat-cli/accounts.json