Install or diagnose the local GreenBubbles CLI and read-only WeChat access. Use for a missing CLI, failed database access, source selection, or initial owner-operated key capture.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Work on the user's Mac with the local CLI. Resolve file links relative to this skill. Setup needs no embedded agent, MCP server, or separate model API key.
Run python3 <this-skill>/scripts/doctor.py first. Supply
--greenbubbles /absolute/path/to/greenbubbles or --profile NAME when known.
The doctor checks capabilities and read-only source access without printing keys
or messages. A failed check is a setup issue, not evidence of empty history.
Read references/setup.md for the relevant installation,
source/profile, or capture steps. Use command -v greenbubbles and
greenbubbles --version to identify the selected executable; 0.10.0 includes
chats find, name selection, and command-line --query search. Do not silently substitute
another executable after a failed check.
Ordinary live use needs no profile after capture: the CLI discovers the account
and reads ~/.greenbubbles-acquire/passphrase.txt. Custom paths belong in
~/.greenbubbles/config.toml. Use profiles for a second account or a snapshot.
Never put credentials in chat, arguments, logs, or projects.
If a source hangs, diagnose one directory open with a timeout before retrying. Workspace permissions, Unix ownership, and macOS privacy access are separate; compare the user's terminal with the agent host and verify changes with a fresh read. Key capture is owner-operated; follow the setup reference's authorization requirements for steps that re-sign WeChat.
After source status succeeds, use context
for a query or personal memory for
maintained notes. Reading messages across all chats is unnecessary to verify
setup. Keep the complete sibling skill package available; installation into
host discovery folders is optional.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Find chats by name, read or search WeChat messages with the local GreenBubbles CLI. Use for bounded live or snapshot queries; route setup problems to greenbubbles-setup and maintained notes to greenbubbles-personal-memory.
The English summary is being prepared. Showing the original description.
Build or revise private, cited Markdown notes from the user's WeChat history in the current agent session. Use for a maintained personal wiki or incremental notes; use greenbubbles-context for a one-off lookup or summary.
The English summary is being prepared. Showing the original description.