skills.rest
openaeon
openaeonCOMMUNITY
Explore all skills by this author →
GitHub

peekaboo-wechat

Automate macOS WeChat messaging using native wechat agent tool actions.

87|20|Updated Mar 9, 2026
Search Tags:#automation#macos#wechat#agent tool#file sharing#message sending#ui targeting
One-click install
npx skills add https://github.com/openaeon/OpenAEON --skill peekaboo-wechat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo-wechat
Source: https://github.com/openaeon/OpenAEON/tree/main/skills/peekaboo-wechat
Command: npx skills add https://github.com/openaeon/OpenAEON --skill peekaboo-wechat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo.

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.

Frequently Asked Questions about peekaboo-wechat

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate WeChat message sending on macOS without keyboard simulation?▼

Automating WeChat message sending on macOS uses the native wechat agent tool for actions like send_text and send_file, bypassing fragile keyboard simulation to ensure reliable message delivery to contacts.

What is the best way to read WeChat chat history for a specific contact programmatically?▼

Reading WeChat chat history for a specific contact involves using the list_chats action to find the target conversation, then applying read_messages to parse chronological message history safely without UI focus drift.

Can I send files to a WeChat group using macOS automation?▼

Sending files to a WeChat group via macOS automation is supported through the native send_file action, which targets verified chat threads using relative UI geometry normalization to prevent coordinate drift.

Does macOS WeChat automation work across multiple monitor resolutions?▼

macOS WeChat automation remains stable across multiple monitor resolutions by applying relative coordinate and geometry normalization logic, reducing focus and coordinate drift during UI targeting operations.

Why does raw Peekaboo CLI fail for WeChat desktop automation?▼

Raw Peekaboo CLI fails for WeChat desktop automation because it introduces state drift and focus problems, whereas strict native tool enforcement using allowed wechat actions ensures deterministic message execution.

Do I need Peekaboo installed to automate WeChat messaging on Mac?▼

Automating WeChat messaging on Mac requires Peekaboo installed as a dependency, providing the foundational environment for the native wechat agent tool to execute list_chats, read_messages, and send operations.

Related Skills

Explore More Software Engineering Skills→
Zentin-LZentin-L
1

peekaboo

Automate macOS UI tasks by capturing screens, targeting elements, and driving input via CLI.

Community
Advanced
XinAlohaXinAloha
3

baoyu-wechat-summary

Summarize WeChat group chat history into structured digests using wx-cli.

Community
Advanced
OmarA1-BakriOmarA1-Bakri

apollo_segment_builder

Create prospect segments in HubSpot CRM using Apollo platform integrations.

Community
Advanced
edwinhuedwinhu
19

dev-test-hammerspoon

Automate macOS applications and desktop workflows using the Hammerspoon scripting engine.

Community
Advanced