Send text and file messages through the desktop WeChat client via CLI automation.
npx skills add https://github.com/dulltackle/kangkang-skills --skill wxsender-dulltackle
Please help me install this Agent Skill. Skill: wxsender Source: https://github.com/dulltackle/kangkang-skills/tree/main/wxsender Command: npx skills add https://github.com/dulltackle/kangkang-skills --skill wxsender-dulltackle
send-text and send-file, with optional --dry-run rehearsal and --force to bypass rate limits when explicitly requested. - Contact Search Positioning: Save each contact's 1-based search result position with contact --set so the automation selects the correct search result every time. - History & Troubleshooting: Query send history, rate-limit status, and safety configuration in JSON to diagnose failures such as missing dependencies, unfound WeChat windows, or rate-limit rejections. - Use Case: A user says "send this report PDF to Zhang San on WeChat" — the agent runs send-file --contact 张三 --file /path/report.pdf, and the CLI activates the WeChat window, searches the contact, pastes the file, and records the result. ## Quick Start Ask the agent to send a WeChat message to a contact, for example: send a WeChat text saying "meeting at 8pm" to contact Zhang San.High-intent search queries and answers about installing and using this skill.
Run the CLI with send-text, passing the contact name and message: python3 scripts/wxsender_cli.py send-text --contact NAME --message "your text". For files or images, use send-file with --file pointing to a local path.
The CLI uses xdotool to find and activate the WeChat window and xclip to place text or files on the clipboard, then simulates Ctrl+F search, Down key navigation, paste, and Enter. Both xdotool and xclip must be installed.
You need a Linux graphical desktop, the desktop WeChat client running and logged in with a window titled 微信, plus the xclip and xdotool utilities installed. Missing dependencies cause preflight failures before any send attempt.
The CLI enforces quiet hours, an hourly send cap, a minimum interval between sends, and a failure cooldown. Run status --json and config --json to see which rule rejected the send, or use --force only when the user explicitly requests bypassing limits.
search-index is the 1-based position of the target contact in WeChat search results; index N triggers N-1 Down key presses. Save it per contact with contact --set NAME --search-index N, since sending without it fails for unconfigured contacts.
No. The --dry-run flag only rehearses the command flow without checking dependencies, window state, rate limits, or performing GUI actions, and it writes no history. Only a real send validates the actual environment.
balaraj74Automate Linux desktop UI interactions using xdotool, xclip, and wmctrl.
GainInsightDevSend project event notifications to Zulip streams and legacy Slack channels.
xianmingyaoExtract contacts, sessions, messages, and favorites from local WeChat SQLite databases.
openakitaOperate WeCom contacts, todos, meetings, messages, schedules, documents, and smartsheets via CLI.