greenbubbles-setup
/greenbubbles-setup
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.
- Author
- bojieli ↗
- Repository
- greenbubbles ↗
- Licence
- MIT
- Last repository change
- 01.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 01.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/doctor.py
What it does and when to use it
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.
Original author description
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.
How it works
- Check access
- Fix the failed check
- Continue the requested task
SKILL.md preview
--- name: greenbubbles-setup description: 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. --- # 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](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](../greenbubbles-context/SKILL.md) for a query or [personal memory](../greenbubbles-personal-memory/SKILL.md) 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.
Files in this package (3)
- SKILL.md 2 KB
- references/setup.md 5 KB
- scripts/doctor.py 2 KB
Versions
The database has no other skills named greenbubbles-setup.
Database snapshot: 13.11.2026 · package version 98f6fbc99125 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90greenbubbles-context
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. - 90greenbubbles-personal-memory
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. - 95wechat-local
读取和分析 Windows 微信(WeChat)聊天记录的 Agent Skill,提供本地 MCP / CLI。支持聊天搜索、消息统计、图片查看、语音转写、视频与附件读取、朋友圈缓存和 Obsidian 导出。用户提到微信聊天记录导出、WeChat MCP、查群聊、转写微信语音、微信数据分析或迁移手机历史时使用。 - 95wechat-setup
First-time setup and health check for driving WeChat for Mac. Builds the native helpers, walks the user through the macOS permissions (Accessibility, Screen Recording, optional Full Disk Access), creates config.toml with their persona, sizes the WeChat window and runs a dry-run… - 100wechat
在本地查询、导出微信 4.1+ 聊天记录为 AI 可读文本 —— 支持双人会话、群聊、以及按消息量排名的重要联系人排名。当用户想导出、搜索或分析自己的微信聊天记录,或为其他 skill(前任.skill / 同事.skill 等)准备聊天记录原材料时使用。