wx-cli

Query local WeChat data for chat history, contacts, sessions, and favorites.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jackwener/wx-cli --skill wx-cli-jackwener
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wx-cli
Source: https://github.com/jackwener/wx-cli/tree/main
Command: npx skills add https://github.com/jackwener/wx-cli --skill wx-cli-jackwener

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires wx-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a command-line interface to query local WeChat data, allowing users to easily access chat history, contacts, sessions, favorites, and more.

Core Features & Use Cases

  • Chat History: Retrieve chat history, search messages, and filter by date and keywords.
  • Contacts: List and search contacts, view member information in groups.
  • Sessions: View recent sessions and unread messages.
  • Favorites: List and search favorites, including images, articles, and videos.
  • Use Case: Imagine you want to find a specific message from a chat session that occurred a month ago. Use this Skill to search for the message by date and keywords.

Quick Start

Use the wx-cli skill to retrieve the chat history for the user 'John Doe'.

Frequently Asked Questions about wx-cli

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

FAQPage Schema
How do I extract WeChat chat history from a local database?

You can query local WeChat data using a command-line interface to retrieve chat history, filtering messages by date and keywords. This requires the wx-cli tool to be installed and initialized first.

Can I search WeChat contacts and group member information locally?

Yes, you can search WeChat contacts locally by listing and querying contact records, which also enables you to view specific member information within group chats.

Do I need wx-cli installed to query local WeChat favorites and sessions?

Yes, querying local WeChat favorites and sessions requires the wx-cli dependency to be installed and initialized to access the underlying local database.

What is the best way to find old WeChat messages without scrolling manually?

The best way to find old WeChat messages is querying the local database with a command-line tool, searching past chat history directly by applying date and keyword filters.

How to retrieve unread WeChat messages and recent sessions from local storage?

You retrieve unread messages and recent sessions by querying local WeChat data via command-line, directly accessing the sessions table to view recent activity and unread counts.