peekaboo-wechat

What problem does it solve?

This Skill removes unreliable, manual, and error-prone WeChat automation by providing a deterministic playbook that always uses the native macOS wechat agent tool instead of fallback command or keyboard simulation approaches.

Core Features & Use Cases

• Strict native tool enforcement: Executes all actions only through allowed-tools: wechat, preventing state drift and focus problems.
• Chat discovery and unread scanning: Lists recent chats and identifies message previews and unread counts to target the right conversation.
• Chronological message reading and safe composing: Reads messages in order and sends text or files to a specified contact/group.
• Robust UI targeting: Uses relative coordinate and geometry normalization logic to remain stable across different resolutions and multi-monitor setups.

Use case: You need to send a consistent status update (text or an image/file) to a specific WeChat group, and reliably verify you’re reading the correct chat thread before sending.

Quick Start

Use the wechat automation skill to list chats, read messages for the target group, and then send your message or file to that exact contact.