gitwtfhub

wtf is vantasma-toolkit?

larkin0302/vantasma-toolkit — explained in plain English

Analysis updated 2026-05-18

16PythonAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A personal-use toolkit of Python CLI tools and Claude Code skills for reading and organizing your own WeChat and Feishu data.

Mindmap

mindmap
  root((vantasma toolkit))
    What it does
      Reads own WeChat data
      Reads own Feishu data
      Claude Code skills
    Tech stack
      Python
      SQLCipher
      Claude Code
    Use cases
      Search chat history
      Daily group summary
      Feishu automation
    Audience
      Personal use only
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

List and search your own WeChat conversations from the command line

REASON 2

Generate a styled HTML daily summary of a WeChat group chat

REASON 3

Automate building Feishu multi dimensional tables

REASON 4

Convert Feishu meeting notes into a client proposal document

What's in the stack?

PythonSQLCipherClaude Code

How it stacks up

larkin0302/vantasma-toolkit920linjerry-stack/capital-studioadya84/ha-world-cup-2026
Stars161616
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/53/52/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires unlocking your local WeChat SQLCipher database during a setup step.

Wtf does this do

Vantasma-toolkit is a personal-use-only collection of Python tools and Claude Code skills for querying and working with data from WeChat and Feishu, two popular Chinese communication platforms. The project is explicitly labeled for personal learning purposes only and prohibits use on other people's accounts or for commercial data collection. The main component is vchat, a command-line tool with 63 subcommands that reads and decrypts WeChat's local database (the messages stored on your own device). After running a setup step that unlocks the encrypted local database, you can list recent conversations, pull chat history from a specific group, search across all messages by keyword, view group members and their avatars, or watch a chat in real time for new messages. Output can be formatted as JSON for use by AI agents. The local database uses SQLCipher encryption, which the tool handles during setup on macOS (with a Windows equivalent). Beyond vchat, the toolkit includes six Claude Code skills, reusable AI instruction sets that extend Claude Code's capabilities. These cover generating styled HTML daily summaries of WeChat group conversations, performing Chinese astrology analysis (combining four pillars, Zi Wei Dou Shu, and Liu Ren methods) and exporting the result as an HTML scroll and image, automating Feishu multi-dimensional table construction, converting Feishu meeting notes into client proposal documents, and calling DiDi ride-hailing through Feishu. Installing a skill means copying its folder into Claude Code's skills directory and restarting the tool.

Yoink these prompts

Prompt 1
Walk me through setting up vchat to unlock and query my local WeChat database on macOS
Prompt 2
Use vchat to search all my WeChat messages for a specific keyword
Prompt 3
Install the Claude Code skill that builds an HTML daily summary of a WeChat group chat
Prompt 4
Use the Feishu skill to turn my meeting notes into a client proposal document

Frequently asked questions

wtf is vantasma-toolkit?

A personal-use toolkit of Python CLI tools and Claude Code skills for reading and organizing your own WeChat and Feishu data.

What language is vantasma-toolkit written in?

Mainly Python. The stack also includes Python, SQLCipher, Claude Code.

How hard is vantasma-toolkit to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is vantasma-toolkit for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.