The share extension WeChat and your AI agent were both missing
WeChat 4.x can merge-forward whole chats as a ZIP, but Claude and Codex ship no share extension to catch it — WeChatBridge registers twelve and routes the archive into your agent, Obsidian, or the clipboard.

What it does A native macOS app (Swift 6, macOS 14+) that registers twelve share extensions inside WeChat’s “forward to other apps” menu. Multi-select a chat, merge-forward, and the archive WeChat generates — a ZIP of text, images, and video — goes straight to Codex, Claude, Doubao, Qwen Office, WorkBuddy, WeSight, DeepSeek Harness, Obsidian, a folder, the clipboard, or any app you add. For agents it activates the target, attaches a scene prompt, and pastes; for Obsidian it writes a Markdown note organized by chat name with the original ZIP kept alongside.
The interesting bit This is orchestration glue and admits it — a second development on the Dukou project — but here the glue is the product: app activation, simulated pasting, permission choreography, and fallbacks, all native. It never reads WeChat’s database; it only catches what WeChat willingly exports, and the share extension runs sandboxed with no network entitlement. For long chats there’s a batch-collect mode: forward several ZIPs in a row, then pick a target and scene once at the end.
Key highlights
- Twelve toggleable entries; apps that aren’t installed get flagged in settings
- Scene prompts per group chat, plus
SKILL.mdmanagement for agent skill packs - Custom targets accept any macOS app; terminal apps can take just the file path
- If a target is missing or permissions fail, the files stay on the clipboard
- Fully local, bilingual (Chinese/English), shipped as a signed, notarized DMG
Caveats
- Auto-paste needs Accessibility permission and chat-name detection needs Screen Recording — a hefty ask for a chat tool, though the README documents exactly what each is used for
- Requires macOS 14+ and WeChat 4.1.13+, the version that added third-party forwarding
- Sparkle auto-update is wired but not enabled in the current release, so updates mean fetching new DMGs
Verdict If your work chats live in WeChat and your assistant lives on the same Mac, this deletes a genuinely tedious copy-paste loop. If WeChat isn’t your chat client, move along.
Frequently asked
- What is freestylefly/WeChatBridge?
- WeChat 4.x can merge-forward whole chats as a ZIP, but Claude and Codex ship no share extension to catch it — WeChatBridge registers twelve and routes the archive into your agent, Obsidian, or the clipboard.
- Is WeChatBridge open source?
- Yes — freestylefly/WeChatBridge is open source, released under the MIT license.
- What language is WeChatBridge written in?
- freestylefly/WeChatBridge is primarily written in Swift.
- How popular is WeChatBridge?
- freestylefly/WeChatBridge has 2.4k stars on GitHub.
- Where can I find WeChatBridge?
- freestylefly/WeChatBridge is on GitHub at https://github.com/freestylefly/WeChatBridge.