What do you want to do?
4 use cases
-
Turn chosen WeChat chats into cited personal notes
Have a coding agent write a private wiki from your chats, with each fact tied to its source message.
- Greenbubbles
- Claude Code
- Codex
- Gemini CLI
- Personal productivity
- Intermediate
View prompt
Use the GreenBubbles personal-memory skill in the repo bojieli/greenbubbles at <skill path>. Read chats from the last month through the greenbubbles CLI and write Markdown notes, one article per life topic, with each fact citing its source message. Verify that every note fact has a citation and that no passwords or keys appear in the output.
-
Find a past message in one WeChat chat by keyword
Search the text of a single conversation from the command line without scrolling through WeChat.
- Greenbubbles
- Personal productivity
- Intermediate
View prompt
Use the greenbubbles CLI from the repo bojieli/greenbubbles to search one chat. Run `greenbubbles messages search --conversation "<chat name>" --query "<keyword>"` and report the matching messages as JSON Lines. Verify that every returned message has its chat name and local time before you summarize it.
-
Rank your WeChat chats to choose which ones to review
List your most active conversations, with one-on-one chats first, before deciding what to summarize.
- Greenbubbles
- Personal productivity
- Intermediate
View prompt
Use the greenbubbles CLI from the repo bojieli/greenbubbles to rank my chats with `greenbubbles chats rank`. Return the top 10 conversations with their names and self-message counts. Verify that one-on-one chats appear before group chats in the output.
-
Make an encrypted backup of your WeChat history
Create a copy of your chat history protected by a 24-word recovery phrase, readable later without WeChat.
- Greenbubbles
- Personal productivity
- Advanced
View prompt
Following docs/RECOVERABLE_SNAPSHOTS.md in the repo bojieli/greenbubbles, help me create an encrypted snapshot of my WeChat history. Report the snapshot location and confirm the 24-word recovery phrase was shown. Verify that the recovery phrase is not written to any file or sent in a prompt.
How to use Greenbubbles
- Check you have what it needs: A Mac with Apple silicon running macOS 14 or later; WeChat installed and running on that Mac; Administrator access for the one-time key setup.
- Open bojieli/greenbubbles on GitHub and read the README and license.
- Run
brew tap bojieli/greenbubbles https://github.com/bojieli/greenbubbles.git - Run
brew install bojieli/greenbubbles/greenbubbles - Follow the key setup steps in docs/PASSPHRASE_ACQUISITION.md so GreenBubbles can read your WeChat data
- Run
echo "$(brew --prefix greenbubbles)/libexec/skills/greenbubbles-personal-memory/SKILL.md"to get the skill path
These steps come from our top use case, Turn chosen WeChat chats into cited personal notes, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeGreenbubbles alternatives · Best AI repos for Personal productivity
About this repo
- Who it is forTechnical Mac users on Apple silicon who want to search their own WeChat history or have a coding agent turn it into private notes.
- Why it is hot
- LanguageRust
- Sourcegithub.com/bojieli/greenbubbles · Back to Hot repos
Requirements
- A Mac with Apple silicon running macOS 14 or later
- WeChat installed and running on that Mac
- Administrator access for the one-time key setup
- Homebrew, or the DMG or ZIP from the Releases page
- A coding agent such as Claude Code, Codex, or Gemini CLI, if you want agent-written notes
Maintain Greenbubbles? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/bojieli-greenbubbles/?ref=badge)
Questions about Greenbubbles
What is Greenbubbles?
GreenBubbles is a Mac command-line tool and agent skill set that lets you read, search, and back up your own WeChat history from the local databases on your computer. It is an open-source project on GitHub: https://github.com/bojieli/greenbubbles.
Who is Greenbubbles for?
Technical Mac users on Apple silicon who want to search their own WeChat history or have a coding agent turn it into private notes.
What can I do with Greenbubbles?
4 use cases so far, for example: Turn chosen WeChat chats into cited personal notes; Find a past message in one WeChat chat by keyword; Rank your WeChat chats to choose which ones to review. Each has steps and a copy-paste agent prompt.
What do I need to run Greenbubbles?
A Mac with Apple silicon running macOS 14 or later; WeChat installed and running on that Mac; Administrator access for the one-time key setup; Homebrew, or the DMG or ZIP from the Releases page.
What are alternatives to Greenbubbles?
Other hot AI repos in Personal productivity: Abacusai Bot, Unigit Ecosystem, Comma, Agent Peer Chat, Compass.
Is Greenbubbles safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.