# AI use cases for Greenbubbles (bojieli/greenbubbles) Repo: [bojieli/greenbubbles](https://github.com/bojieli/greenbubbles) | Use cases: 4 | Page: https://dedupedai.com/use-cases/bojieli-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. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Turn chosen WeChat chats into cited personal notes: https://dedupedai.com/use-cases/bojieli-greenbubbles/turn-chats-into-cited-personal-notes/ - Find a past message in one WeChat chat by keyword: https://dedupedai.com/use-cases/bojieli-greenbubbles/search-one-chat-for-a-keyword/ - Rank your WeChat chats to choose which ones to review: https://dedupedai.com/use-cases/bojieli-greenbubbles/pick-the-chats-worth-summarizing/ - Make an encrypted backup of your WeChat history: https://dedupedai.com/use-cases/bojieli-greenbubbles/make-an-encrypted-history-backup/ ## How to turn chosen WeChat chats into cited personal notes with Greenbubbles Repo: [bojieli/greenbubbles](https://github.com/bojieli/greenbubbles) | Difficulty: Intermediate | Time: 60 min | Basis: From the README Have a coding agent write a private wiki from your chats, with each fact tied to its source message. **Who it is for:** A person with months of WeChat conversations who wants a searchable record of their own life and uses a coding agent already. **The problem:** Useful facts and plans are scattered across many chats, and copying them by hand into notes takes too long. **The outcome:** A set of short Markdown articles, one per part of your life, where each fact cites the original message. Later runs add only new messages, and Git records each change. ### Steps 1. Run `brew tap bojieli/greenbubbles https://github.com/bojieli/greenbubbles.git` 2. Run `brew install bojieli/greenbubbles/greenbubbles` 3. Follow the key setup steps in docs/PASSPHRASE_ACQUISITION.md so GreenBubbles can read your WeChat data 4. Run `echo "$(brew --prefix greenbubbles)/libexec/skills/greenbubbles-personal-memory/SKILL.md"` to get the skill path 5. Ask your agent: Read the GreenBubbles personal-memory SKILL.md at that path. Organize my conversations in the recent month into Markdown notes. ### Prompt to paste into your agent ```text Use the GreenBubbles personal-memory skill in the repo bojieli/greenbubbles at . 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. ``` ### Caveat If your coding agent uses a cloud model, the messages it reads are sent to that provider, and the agent has the same file access you have. Risk, credentials: Key setup copies a key out of your WeChat app with administrator access and re-signs your WeChat copy, and the agent must never receive your database key or recovery phrase. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/bojieli-greenbubbles/turn-chats-into-cited-personal-notes/ ## How to find a past message in one WeChat chat by keyword with Greenbubbles Repo: [bojieli/greenbubbles](https://github.com/bojieli/greenbubbles) | Difficulty: Intermediate | Time: 60 min | Basis: From the README Search the text of a single conversation from the command line without scrolling through WeChat. **Who it is for:** A person who remembers a detail from an old chat, such as an address, a date, or a promise, and wants it fast. **The problem:** WeChat's own search is slow to scan old history, and scrolling through a long chat is tedious. **The outcome:** A JSON Lines list of matching messages from that chat, with sender, local time, and text, plus a cursor if more results exist. ### Steps 1. Run `brew tap bojieli/greenbubbles https://github.com/bojieli/greenbubbles.git` 2. Run `brew install bojieli/greenbubbles/greenbubbles` 3. Run `greenbubbles chats find "Alice"` to confirm the chat name 4. Run `greenbubbles messages search --conversation "Alice" --query "keyword"` 5. If the output says `hasMore: true`, run the same command with `--cursor` set to the `nextCursor` value ### Prompt to paste into your agent ```text Use the greenbubbles CLI from the repo bojieli/greenbubbles to search one chat. Run `greenbubbles messages search --conversation "" --query ""` and report the matching messages as JSON Lines. Verify that every returned message has its chat name and local time before you summarize it. ``` ### Caveat Setup requires the key capture from your running WeChat app, and the README says WeChat may change its private formats, so an update can break reading. Risk, credentials: Setup needs the one-time key copy from your WeChat app, which requires administrator access. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/bojieli-greenbubbles/search-one-chat-for-a-keyword/ ## How to rank your WeChat chats to choose which ones to review with Greenbubbles Repo: [bojieli/greenbubbles](https://github.com/bojieli/greenbubbles) | Difficulty: Intermediate | Time: 45 min | Basis: From the README List your most active conversations, with one-on-one chats first, before deciding what to summarize. **Who it is for:** A person with hundreds of WeChat chats who wants to focus any note-taking or review on the conversations they use most. **The problem:** Most chats are inactive or group noise, and it is hard to tell which ones deserve a closer look. **The outcome:** A ranked list of your chats by how many messages you sent, with one-on-one chats listed first, which you can use to pick targets for a summary. ### Steps 1. Run `brew tap bojieli/greenbubbles https://github.com/bojieli/greenbubbles.git` 2. Run `brew install bojieli/greenbubbles/greenbubbles` 3. Run `greenbubbles chats rank` 4. Run `greenbubbles chats rank --minimum-self-messages 25` to raise the threshold (the default is 10) (inferred, check the README) 5. Pick the chats to pass to `greenbubbles messages list --conversation ""` (inferred, check the README) ### Prompt to paste into your agent ```text 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. ``` ### Caveat The ranking counts only messages you sent, so a chat you mostly read may rank low even if it matters to you. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/bojieli-greenbubbles/pick-the-chats-worth-summarizing/ ## How to make an encrypted backup of your WeChat history with Greenbubbles Repo: [bojieli/greenbubbles](https://github.com/bojieli/greenbubbles) | Difficulty: Advanced | Time: 75 min | Basis: From the README Create a copy of your chat history protected by a 24-word recovery phrase, readable later without WeChat. **Who it is for:** A person who wants a durable copy of years of chat history before changing phones or after a WeChat update. **The problem:** Your history lives inside WeChat's own files, which you cannot easily keep, move, or open without the app. **The outcome:** An encrypted snapshot of your history that you can open later, as long as you keep the 24-word recovery phrase. ### Steps 1. Run `brew tap bojieli/greenbubbles https://github.com/bojieli/greenbubbles.git` 2. Run `brew install bojieli/greenbubbles/greenbubbles` 3. Read docs/RECOVERABLE_SNAPSHOTS.md for the snapshot steps 4. Create the snapshot following that guide, and write down the 24-word recovery phrase 5. Store the recovery phrase and the backup in separate safe places ### Prompt to paste into your agent ```text 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. ``` ### Caveat The backup contains private messages, so the README says to protect it as carefully as WeChat's own data. Risk, credentials: Losing the 24-word recovery phrase means the encrypted backup cannot be opened, and pasting it into an agent prompt exposes it. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/bojieli-greenbubbles/make-an-encrypted-history-backup/