LumaryLabsLLC/muxin

All your machines, one app. For you and your AI agents: agent sessions, desktops, files, logs and GitHub across your Macs, Linux and Windows machines, with an MCP server.

什么是 Muxin？

Muxin 是一款原生桌面应用程序，让您可以管理自己的计算机集群（无论是 Mac、Linux 还是 Windows PC），并允许 AI 驱动的代理（如 Claude Code、Codex、Gemini CLI 等）将这些机器用作工作区。它提供了一个图形化中心，用于：

基于 SSH 的机器清单 – 发现、添加并监控任何可以通过 ssh 或 Tailscale 访问的机器。
实时桌面共享 – 在应用内查看并与远程机器的屏幕进行交互。
文件/剪贴板同步 – 在机器之间（甚至跨操作系统）复制文件/文件夹。
自托管 GitHub runner 管理 – 在任何机器上安装、启动、停止和监控 GitHub Actions runner。
代理会话 – 在任何机器上启动一个运行 LLM 支持的“代理”（Claude Code、Codex、Gemini 等）的终端；即使关闭 UI，会话也会持续存在。
工作区 – 机器上的持久文件夹（可选 git 检出），代理可以在其中编辑和运行代码。
健康监控 – CPU、内存、磁盘、正常运行时间，以及机器离线时的自然语言状态。

所有这些功能也通过 Model Context Protocol (MCP) 服务器 (muxin mcp) 暴露，AI 代理可以以编程方式调用这些功能。

谁会使用它？

拥有个人集群的开发者 – Mac Studio、NUC、笔记本电脑、云虚拟机——想要一个统一的 UI 来查看哪里正在运行什么。
运行自托管 GitHub Actions 的团队 – 在任何机器上快速安装和监管 runner。
AI 代理高级用户 – 让 Claude Code、Codex、Gemini 等直接在选定的机器上操作、编辑文件、运行构建并报告结果。
系统管理员 – 监控健康状况、通过 Wake-on-LAN 唤醒机器，并在多个主机上执行命令。

它是如何工作的？

发现 – Muxin 读取 ~/.ssh/config、Tailscale 和本地网络广播 (Bonjour) 来建议机器。
连接 – 它使用您现有的密钥/代理通过 SSH 连接到每个主机。连接后，它会部署一个小型 Muxin agent（用 Rust 编写），该代理使用 MCP 协议进行通信。
UI 层 – 桌面 UI 使用 GPUI 构建，这是一个 GPU 加速的 Rust UI 框架（与 Zed 编辑器相同）。它可以在 macOS、Linux 和 Windows 上原生运行。
MCP 服务器 – muxin mcp 在本地运行，并将 JSON 编码的命令转发给远程代理。基于 LLM 的代理可以配置为调用这些工具，从而赋予它们“代理优先”的能力。
状态 – 所有配置都位于 ~/.config/muxin/（或 Windows 上的 %APPDATA%\muxin\）下的单个 config.toml 中。运行时状态（最后检查时间戳、直接连接信息）存储在随附的 JSON 文件中。

您可以用它做什么？

功能	示例用例
代理会话	在远程 Mac 上打开 Claude Code 终端，让它修复构建错误，并在关闭 UI 后保持会话活跃。
桌面共享	查看 Linux 盒子的 GUI 以排查 UI 错误，而无需离开您的主工作站。
文件同步	将文件夹从 Mac 拖到 Windows VM 的侧边栏中以立即复制。
Runner 管理	在 NUC 上安装两个 GitHub Actions runner，启动它们，并从概览页面查看它们的作业队列。
健康仪表板	一目了然地查看每台机器的 CPU % 和磁盘使用情况；点击警告以自动重启 Linux 主机。
全集群运行命令	在所有 macOS 机器上执行 `brew upgrade` 并并排查看每个输出。
工作区	在远程机器上创建一个检出仓库的工作区；AI 代理编辑代码、运行测试并推送更改。
MCP 工具	从脚本中：`muxin mcp run_on_machines "git pull" --machines mac-studio,raspberry-pi` 以更新各处的仓库。
Wake-on-LAN	在开始构建之前，在 UI 中按 Wake 唤醒休眠的桌面。

如何开始？

下载 – 从最新的 GitHub 发布页面获取相应的安装程序（DMG、.deb/.rpm/AppImage 或 Windows .exe）。也支持 Homebrew。
运行 – 启动应用程序；它会自动将当前计算机添加到 config.toml。
添加机器 – 按 ⌘N（或 Add Machine 按钮）并从建议中选择（SSH 配置、Tailscale、Bonjour）。
探索 – 使用 ⌘T 打开代理会话，使用 ⌘6 在多台主机上运行命令，或使用 Jobs 视图查看 GitHub runner 活动。
启用 AI 代理 – 按照“Use it from AI agents”部分，将 Claude Code、Codex 或任何兼容 MCP 的客户端指向 muxin mcp。

它有什么限制？

需要 SSH 访问 – 机器必须可以通过 SSH（或 Tailscale）访问，并允许安装小型 Muxin agent。
仅限自托管 – 它管理您拥有的机器；它不提供云实例。
GUI 密集型 – 虽然存在 CLI (muxin …)，但大多数日常交互是通过图形化 UI 进行的。
代理支持 – 内置工具假设代理理解 MCP 协议（Claude Code、Codex、Gemini CLI 等）。其他代理需要自定义 MCP 客户端代码。

谁构建了它？

Muxin 是 Lumary Labs LLC 的一个开源项目，并以 Apache-2.0 许可证发布。开发使用 Rust，并利用了 GPUI UI 框架。

快速参考（命令）

# 演示模式 – 不触及真实机器
muxin --demo

# 添加机器 (SSH 主机)
muxin add-machine --name "Mac Studio" --host ci@mac-studio.local

# 在多台机器上运行命令
muxin run_on_machines "df -h /" --machines mac-studio,raspberry-pi

# 启动 MCP 服务器 (供 AI 代理使用)
muxin mcp

总结

Muxin 是一款原生的跨平台集群管理器，它将您的个人硬件与现代 LLM 代理连接起来，为您提供了一个统一的地方来查看健康状况、运行命令、管理 GitHub runner，并让 AI 代理在您的任何机器上执行操作。