Repolode
Submit
freestylefly

freestylefly/WeChatBridge

A native macOS tool that forwards WeChat chat-history exports to AI agents and Obsidian via the WeChat share menu.

View on GitHubWebsite
Stars
2,030
Forks
537
Open issues
23
Last commit
15 hours ago

What is it?

WeChatBridge adds a set of targets to the "forward to other apps" menu in macOS WeChat. After you multi-select chat messages and use WeChat's merged forwarding, the resulting ZIP of text, images and videos can be sent directly to AI agents such as Codex, Claude, Doubao and DeepSeek Harness, saved as Markdown notes in Obsidian or a folder, or copied to the clipboard. MacOS only lists apps that ship a Share Extension, so this project provides the entry point that WeChat otherwise lacks.

The tool works only with files WeChat exports itself. It does not read WeChat's database or modify the WeChat process, and the Share Extension runs in the sandbox without network access. Scenes store per-chat prompts, a skills center manages SKILL.md files for compatible agents, and a local history lets users resend, copy or clean up batches. If a target app is missing or permissions are lacking, the files remain on the clipboard.

The project is written in Swift with Swift Package Manager, requires macOS 14 or later, and includes a Windows edition in the same repository.

Key features

  • 01Adds twelve built-in targets to the WeChat forward menu, including AI agents, Obsidian and clipboard.
  • 02Sends the merged chat ZIP to an agent with a scene-specific prompt and auto-pastes it.
  • 03Writes Markdown notes to Obsidian or a chosen folder while keeping the original attachments.
  • 04Lets users add any macOS app as a custom target, and terminal apps can receive only file paths.
  • 05Collects more than 100 messages across several batches before sending them together.
  • 06Keeps the chat data local and runs the Share Extension without network access.

Use cases

  • Sending a long group chat to Claude or Codex for summarization or action-item extraction.
  • Archiving important WeChat conversations into an Obsidian vault as searchable notes.
  • Keeping a local folder of chat exports with their images and videos for later reference.
  • Feeding recurring group discussions to an agent with a saved prompt for each group.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/freestylefly/WeChatBridge.git
  2. 2

    Enter the macOS directory and run the tests

    cd WeChatBridge/macos && swift test
  3. 3

    Build the release app

    CONFIG=release Scripts/make-app.sh
  4. 4

    Install the dev build and register the share extension, then enable entries in WeChatBridge settings

    Scripts/install-dev-build.sh

Things to know

  • macOS only for the native app; Windows is a separate edition.
  • Requires macOS 14 or later and Xcode 16 or Swift 6 tools to build from source.
  • Auto-paste needs Accessibility permission and chat-name detection needs Screen Recording permission.

In collections

Open-source AI agent frameworks & appsOpen-source Mac apps

Topics

#wechat#macos#obsidian#ai-agent#chat-history#share-extension#swift

FAQ

What is WeChatBridge?
A native macOS tool that forwards WeChat chat-history exports to AI agents and Obsidian via the WeChat share menu. WeChatBridge adds a set of targets to the "forward to other apps" menu in macOS WeChat. After you multi-select chat messages and use WeChat's merged forwarding, the resulting ZIP of text, images and videos can be sent directly to AI agents such as Codex, Claude, Doubao and DeepSeek Harness, saved as Markdown notes in Obsidian or a folder, or copied to the clipboard. MacOS only lists apps that ship a Share Extension, so this project provides the entry point that WeChat otherwise lacks.
Is WeChatBridge free to use? What license does it have?
WeChatBridge is open source under the MIT license. Check the license terms before using it in commercial products.
Is WeChatBridge still maintained?
Actively maintained. The last commit to WeChatBridge was on Nov 6, 2026.
What can I use WeChatBridge for?
Sending a long group chat to Claude or Codex for summarization or action-item extraction. Archiving important WeChat conversations into an Obsidian vault as searchable notes. Keeping a local folder of chat exports with their images and videos for later reference. Feeding recurring group discussions to an agent with a saved prompt for each group.
How do I install WeChatBridge?
Clone the repository: git clone https://github.com/freestylefly/WeChatBridge.git Enter the macOS directory and run the tests: cd WeChatBridge/macos && swift test Build the release app: CONFIG=release Scripts/make-app.sh Install the dev build and register the share extension, then enable entries in WeChatBridge settings: Scripts/install-dev-build.sh
Where can I get WeChatBridge?
The source code and installation instructions are on GitHub: https://github.com/freestylefly/WeChatBridge

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects