bojieli/greenbubbles

解決する課題

GreenBubblesを使用すると、データを手動でエクスポートすることなく、macOS上で自身のWeChatチャット履歴にアクセスして検索できます。特に、AIエージェント（Claude CodeやCodexなど）がこの履歴をリアルタイムで読み取り、会話に基づいた構造化ノート、プライベートWiki、または生活の要約を作成できるようになります。

仕組み

このツールはMacのCLIおよびオプションのアプリとして動作し、マシン上にローカル保存されているWeChatのオリジナルの暗号化データベースを読み取ります。実行中のWeChatアプリからアカウントの暗号化キーを取得するために、一度だけセットアップ（管理者権限が必要）を行う必要があります。キーを取得すると、GreenBubblesはライブデータベースを直接クエリし、人間やAIエージェントが利用可能なJSON Lines形式で結果を返します。また、コーディングエージェントがCLIを使用してチャットデータを取得・整理する方法をガイドする「スキル」（Markdown指示ファイル）も提供しています。

対象ユーザー

個人のナレッジ管理のためにWeChat履歴をプログラムでアクセスしたい、あるいはAIエージェントに個人的なコンテキストを追加したい技術志向のmacOSユーザー（Apple silicon, macOS 14+）。

ハイライト

• リアルタイムアクセス: ライブデータベースを直接読み取るため、手動エクスポートや重複コピーの管理が不要です。
• エージェント統合: 人気のコーディングエージェント向けに、会話を引用付きのMarkdownノートに変換する定義済みスキルを提供します。
• ローカルファーストのプライバシー: 読み取り、検索、保存はすべてMac上でローカルに行われます。ユーザーが明示的にクラウドベースのAIプロバイダーを使用しない限り、データがデバイスから外部へ送信されることはありません。
• 暗号化バックアップ: 24語のリカバリーフレーズで保護された、チャット履歴の暗号化スナップショット作成をサポートしています。
• 包括的なCLI: チャットのリスト表示、メッセージ検索、アクティブな会話のランク付け、個人情報の秘匿化を行うツールが含まれています。