安装
预编译包发布在 GitHub Releases:
| 目标 |
包 |
依赖 |
| macOS Apple Silicon |
muxterm-macos-arm64.dmg |
macOS 13+ |
| Linux x86_64 |
muxterm-gtk-linux-x86_64.tar.gz |
GTK4、vte4、OpenSSL、tmux 3.x |
macOS 包使用 ad-hoc 签名,未经过 Apple 公证;首次启动若被 Gatekeeper 拦截,请在系统设置中允许。
快速开始
用 muxterm gui 启动桌面 GUI,或用 muxterm tui 启动终端界面。Linux 按 Alt+P,macOS 按 Cmd+P 打开 QuickConnect。
已有的 tmux 会话、Herdr workspace、Project 与 worktree 都会出现在候选列表里;切换已打开的工作区没有 Core 锁等待。
工作区工作台
tmux 与 Herdr 不是被套进一个假终端,而是各自进入 WorkspacePool:
Workspace = Runtime(Transport) + path
Runtime: shell / tmux / herdr
Transport: local / ssh
结构: Tab → Pane
控制 lane: 拓扑与常驻原生场景
渲染 lane: 原始 PTY 字节直达原生 Surface
Activity lane: Agent、命令与 Attention
端口感知与转发
对于 SSH 工作区,Muxterm 通过现有 SSH 连接扫描目标机上的 TCP 监听端口。macOS 状态栏会列出发现的端口,并支持:
- 把远端端口转发到本地端口;
- 显式开启转发端口的 LAN 访问;
- 打开本地 / 远端地址、忽略端口或停止转发。
扫描使用目标机的 ss 或 lsof,且不在前端线程执行。Core/FFI 已提供接口;当前端口选择器 UI 在 macOS 前端。
配置契约
配置位于 ~/.config/muxterm/config.toml,严格校验 schema:
config_version = 1
[font]
family = "JetBrains Mono"
size = 13.0
[statusbar]
mode = "tmux"
[pool]
max_slots = 20
[theme]
name = "system"
light = "white"
dark = "black"
[shortcuts]
preset = "qwerty"
primary_key = "auto" # Linux=Alt,macOS=Command
[[projects]]
id = "muxterm@local"
name = "Muxterm"
path = "~/Developer/self/muxterm"
CLI 参考
不启动 GUI 也能使用:
# 列出工作区
muxterm list-workspaces
# 隔离 tmux socket
muxterm -L muxterm-test list-workspaces
# 向当前 Pane 发送按键
muxterm send-keys "cargo test"
# 检查配置
muxterm config show --resolved
muxterm config doctor
从源码构建
构建脚本把产物写入 ./build/<os>/:
git clone https://github.com/wlingze/muxterm.git
cd muxterm
./scripts/build-tui.sh --release
./scripts/build-linux.sh --release
./scripts/build-macos.sh --release