Set up GreenBubbles

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.

Check access

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.

Fix the failed check

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.

Continue the requested task

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.