README 目录 / tmux

tmux

这个仓库里最核心的终端工作流配置。它不只是 ~/.tmux.conf，还包含 session 管理脚本、状态栏、布局工具、agent tracker 集成和 tmux 专用 Starship 配置。

核心工作流状态栏脚本 agent 集成 TPM 插件

安装组合

stow -S tmux

只安装 tmux 包可以生效，但它的完整体验依赖 shell、终端、本地命令和 agent tracker，推荐组合是：

stow -S zsh tmux kitty bin agent-tracker

主要路径：~/.tmux.conf、~/.config/tmux/、~/.config/starship-tmux.toml。

基础行为

prefix 改为 Ctrl+s。
默认 shell 为 /bin/zsh。
开启 mouse、focus events、true color、extended keys。
window 和 pane 从 1 开始编号。
copy mode 使用 vi 风格。
状态栏每秒刷新，由 tmux-status/left.sh 和 right.sh 生成。

脚本职责

session_manager.py：维护 session 编号、重命名、移动和 window 迁移。
open_shell_here.sh：在当前路径打开 shell、window 或 split。
layout_builder.sh：创建固定方向布局。
watch_pane.sh：监听 pane 输出并更新状态栏标记。
restore_agent_*.py：恢复 agent 相关 pane 映射。

高频快捷键

无需 prefix

Alt+S：当前路径新建 session。
Alt+O：把当前 pane break 成 window。
Alt+o：当前路径新建 window。
Alt+Q：关闭当前 pane。
Alt+1..9：切换 window。
Ctrl+1..9、F1..F5：切换 session。
Alt+n/e/u/i：左/下/上/右切换 pane。
Alt+N/E/U/I：调整 pane 大小。
Alt+f：zoom 当前 pane。
Alt+v：进入 copy mode。
Alt+l/y：上一个/下一个 window。
Alt+s/m/M：agent palette、通知 pane、通知来源 pane。

prefix 后

c：新建 session。
.：重命名 session。
,：重命名 window。
u/e/n/i：向上/下/左/右分割 pane。
1..0：把当前 window 移到指定 session。
I/N/U/E：layout builder 创建布局。
Space：切换布局方向。
C-g：切换 synchronize-panes。
W：choose-tree。
P：切换 agent tracker 通知状态。

copy mode 和插件

copy mode 用 v 开始选择，Ctrl+v 矩形选择，n/e/u/i 移动，y 复制到系统剪贴板，Y 复制到行尾。

插件使用 TPM，包括 tmux-plugins/tpm、tmux-resurrect 和 tmux-continuum。默认安装、更新、清理快捷键都改成 M-F12，降低误触概率。

完整体验依赖较新的 tmux、zsh、Python 3、bash、pbcopy/pbpaste、kitty 的 Option-as-Alt 设置，以及已经构建好的 agent-tracker。状态栏脚本在 macOS 上信息最完整。