by earayu
Bring your agent companion into the chat apps you already use. Runs on your machine, no server.
# Add to your Claude Code skills
git clone https://github.com/earayu/MingleGuides for using ai agents skills like Mingle.
See how Mingle compares with popular alternatives.
Mingle is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by earayu. Bring your agent companion into the chat apps you already use. Runs on your machine, no server. It has 50 GitHub stars.
Mingle's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/earayu/Mingle" and add it to your Claude Code skills directory (see the Installation section above).
Mingle is primarily written in TypeScript. It is open-source under earayu on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Mingle against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
English · 中文 · mingle.build
Bring your agent companion into the chat apps you already use. Runs on your machine, no server.
Create an agent on your own computer: it has a name, a role, a memory and a home directory, and a coding agent you already use drives it. The agent joins your chat apps as a bot, where people can @-mention it, hand it tasks and hear back from it.
| Chat apps | WeChat, WeCom, Feishu, DingTalk, QQ, Slack, Discord, Telegram; GitHub issues and pull requests, from an account of the agent's own; iMessage on a Mac, by texting yourself |
| Harnesses | Claude Code, Codex, Cursor, OpenCode, Kimi Code, Grok Build, Qwen Code, Qoder, CodeBuddy Code, DeepSeek Harness, Pi, Antigravity, through OAR |
| Systems | macOS, Windows, Linux |
Mingle is in early development. The core works end to end with Claude Code, Codex, OpenCode and Kimi Code. Feishu is verified on a real tenant; the other chat apps against their APIs and in tests.
Download the desktop app for your system from Releases, or install it from a terminal:
curl -fsSL https://github.com/earayu/Mingle/releases/latest/download/install.sh | sh # macOS, Linux
irm https://github.com/earayu/Mingle/releases/latest/download/install.ps1 | iex # Windows (PowerShell)
The macOS app is signed and notarized by Apple. The Windows app is not signed yet: choose "More info → Run anyway". The app lives in the menu bar or tray, keeps Mingle running in the background, can open at login and updates itself. A harness you don't have yet can be installed and signed in from the app.
In the app: New agent, give it a name and a role, pick a harness, then connect a chat app and follow the steps shown for it. Whoever scans the code, or sends the bot the 6-digit claim code the app shows, becomes the agent's owner.
The same from source, with Node.js 24 and pnpm:
git clone https://github.com/earayu/Mingle.git && cd Mingle
pnpm install && pnpm build
node dist/cli/main.js start # keep this running; opens the console in your browser
node dist/cli/main.js agent create --name Alex --harness claude --role "You help me plan trips."
echo "$TELEGRAM_BOT_TOKEN" | node dist/cli/main.js connect alex telegram
Then send the bot a direct message from your own Telegram account; that makes you its owner.
flowchart LR
chat["Chat apps<br/>WeChat · Feishu · Slack · Telegram · …"] <--> mingle["Mingle<br/>on your computer"]
mingle <--> harness["Your harness<br/>Claude Code · Codex · …"]
mingle command (reply, send, read and search chats, tasks, reminders, an address book); Mingle checks permissions and delivers. Owners can send /stop; there are no other session commands.ROLE.md, MEMORY.md and notes/. Everything else lives in ~/.mingle (MINGLE_HOME), including the log at ~/.mingle/logs/mingle.log (mingle log). Bot credentials are kept only in the macOS Keychain, Windows DPAPI or the Linux Secret Service.127.0.0.1 only.mingle manual prints the agent's full guide.pnpm check (typecheck, lint, tests) must pass.Issues are welcome, in English or Chinese. For a bug, include your version, system, harness, chat app and the relevant lines of mingle log. We aren't accepting pull requests for now. Report security problems privately rather than in a public issue. For anything else, write to earayu@gmail.com.