开源革命性Mac终端Muxy，轻量高效+内置IDE+Git+AI追踪

原文链接：https://mp.weixin.qq.com/s/hlQk8mw_BFaapdle63rRvw

Muxy：Mac终端的革命性开源神器！轻量高效+内置IDE+Git+AI追踪，一文深度拆解安装、用法、架构与实现内幕

一、Muxy值得你立刻尝试

Muxy是一款专为macOS打造的轻量级、高内存效率的原生#终端应用，使用SwiftUI + libghostty构建，支持macOS 14+和Swift 6.0+。它不仅仅是一个终端模拟器，更是一个以项目（Project）为核心的工作流多路复用器，集成了终端、编辑器、文件浏览器、Git版本控制、Markdown预览、AI使用追踪、移动远程控制等功能。

Project-based workflow—— 所有终端、编辑器、分屏、状态都围绕项目和worktree持久化保存，重启后一键恢复完整工作空间。解决了传统终端（如iTerm2 + tmux）在多项目切换时的痛点：配置碎片化、状态丢失、窗口管理混乱。

核心优势：

项目驱动的工作流 + 持久化工作空间状态
垂直标签栏（Vertical tabs）支持拖拽重排序、固定、改名、中键关闭
水平/垂直分屏（Split panes），键盘导航 + 可调整分割线
内置完整VCS（Git状态、unified/split diff、提交历史、分支选择、通过gh创建/列出PR）
Git worktree完整管理（创建、切换、侧边栏跟踪）
内置文件树浏览器（File tree，支持Gitignore、文件操作、剪贴板）
项目内全文搜索（Find in files + 匹配预览）
快速打开 & 命令面板（Quick open & command palette）
原生轻量级文本编辑器（Syntax highlighting、多语言支持、搜索、历史）
Markdown文件内联预览
多AI提供商实时token/费用追踪面板（Claude Code、Codex、Cursor、Copilot、Amp、Factory、Kimi、MiniMax、OpenCode、Z.ai等）
直接从Muxy打开偏好IDE
iOS/Android移动伴侣App远程控制Mac终端
富输入面板（Rich input，支持多行、图片附件、草稿）
应用内通知中心（Notification center，支持socket hook）
200+ Ghostty主题内置选择器
40+可自定义键盘快捷键（带冲突检测）
工作空间持久化（tabs、splits、焦点状态按项目保存）
终端内搜索、拖拽支持（标签拖拽创建分屏、文件路径拖入终端）
每个项目自定义图标和颜色
Sparkle自动更新

二、详细高效的使用方法

Muxy的使用围绕**Project → Worktree → Splits/Tab Area → Tab（Terminal/Editor/VCS/Diff）**的层级结构展开。

创建与管理项目：启动后添加项目文件夹，即可获得持久化工作空间。支持项目图标/颜色自定义、IDE直开、CLI/URL scheme快速跳转。工作空间可过滤成命名侧边栏组（Project Workspaces）。
标签与分屏：垂直标签栏支持拖拽、固定、改名。分屏支持水平/垂直，拖拽标签到窗格边缘即可创建新分屏。键盘快捷键全面可配（40+键位）。
终端核心：底层使用libghostty，提供高性能渲染。支持Ghostty完整配置、终端内搜索、复制粘贴、自定义命令。每个pane有独立PWD跟踪和MUXY_*环境变量（用于通知、AI集成）。
富输入面板：写长命令或AI提示时特别好用，支持多行编辑、图片附件、草稿保存、广播发送到所有pane。
内置编辑器 & Markdown：轻量语法高亮编辑器，直接在Tab中打开文件编辑，支持快速打开、Markdown实时预览（WKWebView渲染）。
Git集成：侧边栏显示仓库状态、diff查看（unified/split）、提交、分支、worktree管理、PR操作（依赖gh CLI）。AI Assistant还能根据diff自动生成commit message和PR描述。
文件树 & 搜索：Gitignore-aware懒加载树，支持文件操作、拖拽。
AI使用追踪：实时面板显示各AI工具的token消耗和费用，支持多种主流提供商。
通知 & 移动远程：WebSocket服务器支持手机App远程控制、通知推送。OSC序列和socket hook可实现外部工具集成（如opencode插件）。
主题 & 自定义：内置200+主题选择器，UI缩放统一控制，键盘快捷键冲突检测。

高效技巧：使用命令面板 + 键盘导航，几乎零鼠标操作；利用布局YAML文件（.muxy/layouts/*.yaml）声明式定义复杂工作空间（layouts文档提供schema和示例）；移动App配对后可随时远程操作终端。

三、安装方法

推荐方式：

-
-

1	`brew tap muxy-app/tap``brew install --cask muxy`

``

手动安装：前往GitHub Releases页面下载最新.dmg或.app，直接拖入Applications。

iOS/Android移动伴侣：分别从App Store和Google Play下载（源码在muxy-app/mobile仓库）。

从源码安装：

克隆仓库：

1	`git clone https://github.com/muxy-app/muxy.git && cd muxy`

运行初始化脚本（下载GhosttyKit.xcframework，这是libghostty的预编译框架）：

1	`scripts/setup.sh`

构建调试版本：

1	`swift build`

运行：

1	`swift run Muxy`

依赖：macOS 14+、Swift 6.0+、可选ghCLI（PR管理）。使用Swift Package Manager（Package.swift），无外部依赖管理器。代码风格严格（swiftformat + swiftlint），运行scripts/checks.sh --fix自动修复。

四、技术原理、架构与实现方式

Muxy采用Clean Architecture设计，代码99.5%为Swift，高度模块化：

包结构（Package Overview）：

Muxy/
：桌面App核心（SwiftUI + AppKit视图）。包含Models（AppState、WorkspaceReducer）、Services（GhosttyService、Git、AI、Notifications、MobileServer等）、Views。
MuxyShared/
：平台无关DTOs（ProjectDTO、WorktreeDTO、SplitNodeDTO等）和MuxyProtocol（WebSocket消息协议、JSON编解码）。
MuxyServer/
：嵌入式WebSocket服务器（NWListener + ClientConnection），支持移动端RPC和事件推送。
GhosttyKit/
：C模块桥接libghostty（ghostty.h），提供xcframework（setup.sh下载）。

状态管理：使用AppState + WorkspaceReducer模式（类似Redux/Composable Architecture），实现可预测的状态更新、持久化（tabs、splits、焦点、cwd）和导航历史。

Ghostty集成：

GhosttyService单例管理ghostty_app_t，加载~/.config/ghostty/config，120fps tick定时器。
GhosttyTerminalNSView（AppKit）托管ghostty_surface_t，附加Metal layer实现高性能渲染。
通过GhosttyRuntimeEventAdapter处理OSC事件、PWD变更、进度报告（GHOSTTY_ACTION_PROGRESS_REPORT，用于侧边进度圈）。
每个surface注入MUXY_PANE_ID、MUXY_PROJECT_ID等环境变量，实现通知路由和IPC。
生命周期严格管理（viewDidMoveToWindow创建surface，viewWillRemoveFromWindow释放），避免SwiftUI NSView复用坑。

其他关键实现：