Macterm：原生 macOS 终端

项目简介

Macterm 是一款面向 macOS 的终端应用，使用 Swift 编写，目标是做到原生、轻量、顺手。它要求 macOS 14 及以上，采用 MIT 许可证。项目与同名的早期 macOS 终端模拟器 MacTerm 没有关系。

主要功能

• 会话持久化：退出 Macterm 后 shell 继续运行，再次打开时每个窗格都会恢复。
• 垂直项目侧边栏：用原生 macOS 侧边栏组织项目及其标签页。
• 分屏与复用：拆分窗格，把一个窗格拖到另一个上，或把窗格移到独立标签页。
• 远程项目：通过 SSH 打开另一台机器上的文件夹，shell 在那一端持续运行。
• 固定标签页：把标签页固定在项目之上，随 Macterm 启动。
• 命令面板：按 ⌘P 查看全部命令，并显示对应快捷键。
• 扩展：为 Git、Docker、Kubernetes、SSH、Claude Code 添加调色板，也可以用 YAML 自己编写。
• 布局保存与恢复：把项目的标签页、分屏和命令保存在一个 YAML 文件里。
• 控制 CLI：脚本和编码 agent 可以用 macterm 命令控制 Macterm。
• 标签页切换器：按住最近标签页快捷键，从实时预览中挑选标签页。
• 复制模式：用 Vim 或 Helix 的按键在回滚缓冲区中移动和选择文本。
• 动画：滚动、分屏和光标平滑就位。
• 快速终端：用全局快捷键在任意应用之上唤出下拉式终端。
• 桌面小组件：把终端放到桌面上，按 macOS 小组件的网格与形状排布。
• 密码自动填充：保存你在提示符处输入过的密码，并在之后自动填入。
• 自适应背景：窗口采用当前运行程序的背景色。
• Ghostty 兼容：沿用 Ghostty 的配置、主题、字体和按键绑定。

安装与使用

Homebrew

brew install --cask thdxg/tap/macterm

cask 在安装时会移除 Gatekeeper 隔离属性，应用启动时没有额外提示。

从 Releases 安装

从 Releases 下载最新的 .dmg，打开后把 Macterm 拖进 Applications。应用没有 Apple 开发者证书签名，需要清除一次隔离标记：

xattr -cr /Applications/Macterm.app

之后由 Sparkle 安装更新，每次更新都会校验 EdDSA 签名，不需要再次执行 xattr。

配置

Macterm 从与 Ghostty 相同的位置读取 Ghostty 配置：~/.config/ghostty/config 或 ~/Library/Application Support/com.mitchellh.ghostty/config。已有配置可直接沿用，一个最小配置示例：

theme = Rose Pine
font-family = JetBrains Mono
font-size = 16

窗口透明度、侧边栏行为、快速终端尺寸和键位映射等 Macterm 自有设置，在 Macterm → Settings 中调整。

扩展

打开 Settings → Extensions，找到扩展并点击 Install，其调色板会立刻出现在命令面板（⌘P）的 Palettes 区域。自建扩展时，在 ~/.config/macterm/extensions/ 下建立文件夹，包含一个 extension.yaml 和存放 YAML 的 palettes/ 目录。

注意事项

• 仅支持 macOS 14 及以上版本。
• 项目与同名的 MacTerm 没有关系。
• 少数默认值与 Ghostty 默认不同（主题、字号、内边距、macos-option-as-alt）；Macterm 还设置了 tab-inherit-working-directory = false，让新标签页在项目根目录打开。Macterm 先加载这些默认值再加载你的配置，你设置的键始终优先。
• 通过 Releases 安装的非签名版本需要手动清除隔离属性，使用 Homebrew cask 则不需要。

---

本作品整理自 GitHub 开源项目 thdxg/macterm，原作者 @thdxg，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。