Repository navigation
Releases
PiMux v1.0.0-beta.2 (Mac contrast and Apple GPU fix)
Fixes unreadable light-terminal views and adds native Apple GPU information.
- Shared contrast handling across Rich views, persistent
pimux theme auto|light|dark, environment override and diagnostics. - Apple GPU model/core identity with optional unprivileged driver utilization. Missing readings stay unavailable. Unified memory is not misreported as dedicated VRAM, and macOS does not request NVIDIA tools.
- Linux NVIDIA behavior is retained. Linux v0.11.0 remains stable/latest.
Apple silicon, macOS 15 or newer. Intel Macs are not validated. This is a source Homebrew formula, not a standalone app or bottle.
Install:
brew tap 2-mo/pimux https://github.com/2-mo/pimux
brew trust --formula 2-mo/pimux/pimux-preview
brew install 2-mo/pimux/pimux-previewUpgrade an existing installation with brew update && brew upgrade pimux-preview, then reopen PiMux. Existing sessions, settings and tasks are retained. If automatic theme selection is insufficient, use pimux theme light or pimux theme dark.
Behavior was validated at 3710a39da6226bf59497fa5d5bfe33519de30f81: Ubuntu 474 passed / 6 skipped; SSH 56 passed; native Mac 417 passed / 2 skipped; Homebrew strict audit, install, test, upgrade, old-keg cleanup and uninstall passed.
Release source: 133011a2533be8849061c92bdb9e2109781ade2a, with version metadata and release documentation updated only. The attached archive is built from that exact commit. Public Homebrew installation is checked by the one-time publication workflow.
Numeric Apple GPU utilization remains hardware-unvalidated because the hosted Mac exposed no GPU inventory. Unsupported values are shown as unavailable, never fabricated as zero. Full multi-server TUI and remote session actions remain deferred.
Fix PR: #7
CI: https://github.com/2-mo/pimux/actions/runs/41904729464 and https://github.com/2-mo/pimux/actions/runs/41904729401
PiMux v1.0.0-beta.1 (Mac Homebrew beta)
First Mac Homebrew beta: native local terminal, independent client window selection, local resource inspectors, and package-managed installation.
Apple silicon, macOS 15 or newer. Intel Macs are not validated. This is a source formula with Homebrew dependencies, not a standalone app or bottle. Linux v0.11.0 remains the stable/latest release.
Install:
brew tap 2-mo/pimux https://github.com/2-mo/pimux
brew trust --formula 2-mo/pimux/pimux-preview
brew install 2-mo/pimux/pimux-preview
pimuxUse brew upgrade pimux-preview and brew uninstall pimux-preview to manage the package. Settings and running sessions are retained. Running tmux servers are not automatically upgraded.
Experimental host discovery and read-only CLI snapshots are available. Full multi-server TUI and remote session attachment/actions remain deferred.
Exact tested source: 48672332c158b027bdf91090e40a4533cfbbca8d. Ubuntu: 416 passed, 5 skipped; SSH: 56 passed; native Mac: 358 passed, 2 skipped. Homebrew strict audit, install, test, upgrade, old-keg cleanup and uninstall passed on macOS 15 arm64. The source archive below is the byte-identical CI artifact, verified by SHA-256.
CI: https://github.com/2-mo/pimux/actions/runs/41895354997 and https://github.com/2-mo/pimux/actions/runs/41895355208
PiMux v0.11.0 (Linux)
Linux milestone release.
- Quiet footer with shortcuts shown after the prefix, and native tmux cancellation.
- Reliable pane previews for unusual paths and foreground working directories.
- Explicit package-upgrade confirmation, verified package ownership, and protection for running servers.
Requires Linux, Bash 4+ and tmux 3.2+. macOS is not included.
Validation: 217 tests passed, one existing Starship check skipped. CI uses Ubuntu tmux 3.4 with the official upstream #4559 backport; this test-only package is not bundled or installed on users' systems.
PiMux 0.10.1: fullwidth pipe split shortcut
Both ASCII | and fullwidth | now split panes left/right after Ctrl-a and inside the action menu. The existing v shortcut remains available.
- Preserve each alias's original behavior in ordinary sessions on shared tmux servers.
- Align fullwidth shortcut labels in keyboard help.
- Verify nested splits and menu input for both forms of the pipe character.
Update with pimux update. Running tasks and saved settings are preserved.
PiMux 0.10.0: background terminal management
Manage experiment terminals from any agent or script with pimux tmux COMMAND ..., without opening an interactive terminal.
- Create and name windows, split panes, inspect output, reuse completed terminals and close exact window or pane IDs using native tmux commands.
- Automatically use the configured PiMux server or the current managed workspace;
--systemselects the system server explicitly. - Preserve native arguments, output and exit status. The caller decides window organization, experiment workflow and cleanup.
See the background management guide for a complete example and instructions to give your agent.
Update with pimux update. Running tasks and saved settings are preserved.
PiMux 0.9.2: clearer keyboard hints
Window actions are easier to find:
- The status bar shows c for a new window, comma for rename and x for closing the current pane. Ctrl-a highlights these actions; narrow terminals use compact hints.
- The action menu opens with Workspace expanded. The manager names the selected session, window or pane in its close hint and keeps creation and confirmation hints visible on narrow screens.
- Help and README screenshots reflect the updated interface.
Update with pimux update. Running tasks and saved settings are preserved.
PiMux 0.9.1 · 连续分屏入口修正
连续分屏的快捷键入口改进。
- 新增 Ctrl-a v 左右分屏,无需输入需要 Shift 的竖线;原来的 Ctrl-a | 继续可用。
- Ctrl-a - 上下分屏,可以在任意选中的分屏里继续交替分割;每次先按并松开 Ctrl-a。
- 操作菜单显示 v 入口,前缀提示补上 v/- 分屏提示。
- 补齐共享系统 tmux 的分屏快捷键,并保留普通会话每个按键原有的行为。
- 修正从共享系统服务更新时,另一套 PiMux 服务的新按键未同步重载的问题。
- 已在真实隔离终端验证六块连续嵌套分屏及布局几何关系。
更新:pimux update。快捷键在配置重载后生效,不重启正在运行的任务。
PiMux 0.9.0 · 分屏直达与布局调整
围绕科研项目的分屏查找和布局操作。
- 首页按 /,逐个搜索项目、窗口、程序和工作目录,Enter 或点击直达目标分屏,包括未聚焦的分屏。
- 工作区菜单新增“调整分屏”:左右均分、上下均分、平铺和换位;进入调整大小模式后,方向键可连续操作,Enter / Esc 完成,Tab 切换目标分屏。
- 首页搜索支持光标移动、Home / End、Delete 和 Ctrl-U,修复重绘间隙控制键可能丢失的问题。
- 返回工具页后保留选中分屏和查询;关闭分屏结果时仍先确认,且只关闭对应分屏。
- 更新中英文帮助和首页截图。布局由同一窗口的连接共享,程序继续运行。
更新:pimux update,然后重新打开 pimux 或 Ctrl-a h。
PiMux 0.8.1 · 窗口异常提示
科研任务的窗口异常提示。
- PiMux Bash 前台命令失败后,窗口编号加粗反色;同一分屏后续命令成功后恢复。
- 多个分屏分别记录退出码,成功、关闭和窗口切换都不会误清除其他分屏的错误。
- Ctrl-C 按取消处理,保留原来的 Bash 退出码与管道状态。
- 管理列表按 d 查看各分屏的上次命令退出码。
更新:pimux update。此前已开的 Bash 需要用 Ctrl-a c 新开窗口以加载命令上报;已有任务继续运行。
PiMux 0.8.0 · 树形菜单与 IP 复制
首页与 Ctrl-a h 统一使用树形菜单,按工作区、资源、网络、设置分组,配以无需额外字体的小符号。
- 宽屏并排显示菜单和会话列表;窄屏用 Tab 切换区域,方向键展开、Enter 或鼠标进入,保留现有快捷键。
- IP 页用方向键或鼠标选中地址,y / Enter 复制 IP,Y 复制 CIDR 子网;支持 IPv6、Tailscale、网关和 MagicDNS 名称。
- 复制只发送给当前终端,同时保留 tmux 缓冲区;本机剪贴板需要终端支持 OSC 52。
- README 首页截图和中英文帮助同步更新;工作区首图展示默认目录状态栏与项目文件列表。
更新:pimux update,完成后重新打开首页或 Ctrl-a h。