tmux 新手指南

tmux -V      # 例如输出 tmux 3.4

tmux new -A -s pi     # 已存在就 attach，不存在才新建 —— 每天只用敲这一条

# 顺手做个别名
echo "alias p='tmux new -A -s pi'" >> ~/.bashrc && source ~/.bashrc

exit                        # 推荐：最后一个窗口里敲 exit（或 Ctrl+d）

tmux kill-session -t pi     # 从外面杀掉指定会话

tmux kill-server            # 杀掉所有会话（等于关掉整个管家）

Ctrl+b  [        → 进入 copy mode（可以滚动）
方向键 / PageUp / PageDown
q               → 退出（新手常以为卡死了，其实是在这个模式里）

Ctrl+b  [     → 进入 copy mode
空格           → 开始选择
方向键         → 扩大选择
回车           → 复制进 tmux 的 buffer
Ctrl+b  ]     → 粘贴

cat > ~/.tmux.conf <<'EOF'
# ============ 基础体验 ============
# 开启鼠标：滚轮滚屏、点面板切换、拖边框调大小、划选复制
set -g mouse on
# 历史缓冲从默认 2000 行提高到 50000 行
set -g history-limit 50000
# 窗口 / 面板从 1 开始编号
set -g base-index 1
set -g pane-base-index 1
setw -g renumber-windows on
# 加快按键响应（对 vim / 快速连按友好）
set -sg escape-time 10
# 正确声明 256 色 / 真彩色，减少乱码
set -g default-terminal "tmux-256color"
set -ga terminal-overrides ",*256col*:Tc"

# ============ pi 专用 ============
# pi 需要扩展键上报，否则 Shift+Enter / Ctrl+Enter 会被当成普通 Enter
set -g extended-keys on
# 仅 tmux >= 3.5 可用；版本低于 3.5 请删掉下面这行
set -g extended-keys-format csi-u

# ============ 复制粘贴（可选）============
set -g set-clipboard on
EOF

# 方式一：在 tmux 外面执行
tmux source-file ~/.tmux.conf

# 方式二：在 tmux 里按 Ctrl+b 松手，按 : ，输入下面这行回车
source-file ~/.tmux.conf

# ——— 每天开工 ———
ssh you@server
tmux new -A -s pi            # 一条命令回到老地方
cd ~/myproject
pi                            # 断过就用 pi -c 续会话

# ——— 要断网 / 关电脑 / 走人 ———
# 按 Ctrl+b，松手，按 d
# 看到 [detached (from session pi)] 就可以安心走了

# ——— 回来 ———
ssh you@server
tmux attach -t pi

# ——— 确认它真的在干活（另开一个 SSH）———
tmux ls                      # 会话还在 = pi 还在
ps aux | grep -i "[p]i"      # 进程还在 = 真在跑

set -g extended-keys on
set -g extended-keys-format csi-u   # 仅 tmux >= 3.5；3.2–3.4 删掉这行

set -sg escape-time 10

set -g focus-events on

set -g set-clipboard on

printf '\033]52;c;%s\a' "$(printf hello | base64)"

# 让终端标题栏显示会话名 + 面板标题
set -g set-titles on
set -g set-titles-string "#S | #T"
# 别让 shell 的自动改名覆盖 agent 设置的标题
setw -g automatic-rename off
# 在每个面板顶部显示编号与标题
set -g pane-border-status top
set -g pane-border-format " #{pane_index} #{pane_title} #{?pane_active,#[fg=green]●ACTIVE,#[default]} "

set -g remain-on-exit on

# 把一整段 prompt 原样送进 pi 所在窗口（:1 是窗口号）
tmux send-keys -t pi:1 -l "$(cat prompt.md)"
tmux send-keys -t pi:1 Enter

# 读取 agent 屏幕上最后 50 行（做监控 / 存档 / 告警）
tmux capture-pane -p -t pi:1 -S -50

# 实时盯梢
watch -n 2 'tmux capture-pane -p -t pi:1 | tail -n 20'

#!/usr/bin/env bash
# 把 PATTERN 换成你服务器上 pi 的进程特征（先跑 ps -ef | grep pi 看一眼）
PATTERN="pi-coding-agent|/bin/pi"

if pgrep -f "$PATTERN" >/dev/null 2>&1; then
  printf '#[fg=green]● pi 在跑'
else
  printf '#[fg=colour240]○ pi 空闲'
fi

set -g status-interval 5
set -g status-right "#(~/bin/pi-status) | %H:%M"

chmod +x ~/bin/pi-status

#!/usr/bin/env bash
# 2 个 agent + 1 个监视面板
set -euo pipefail
SESS=agents
PROJ="$HOME/project"        # 改成你的项目路径

if tmux has-session -t "$SESS" 2>/dev/null; then
  tmux attach -t "$SESS"; exit 0
fi

tmux new-session -d -s "$SESS" -n main   -c "$PROJ"
tmux new-window  -t "$SESS"    -n review -c "$PROJ"
tmux new-window  -t "$SESS"    -n watch  -c "$HOME"

# 主力和审查各起一个 pi
tmux send-keys -t "$SESS:main"   'pi'    C-m
tmux send-keys -t "$SESS:review" 'pi -r' C-m
# 监视窗口实时回放主力 agent 的屏幕
tmux send-keys -t "$SESS:watch"  'watch -n 5 "tmux capture-pane -p -t agents:main | tail -n 20"' C-m

tmux select-window -t "$SESS:main"
tmux attach -t "$SESS"

chmod +x ~/bin/agents-layout

# 杀掉某个会话时，自动切到别的会话，而不是直接把你踢出 tmux
set -g detach-on-destroy off
# 面板历史：agent 输出量大，50000 行足够；别开到 100 万（每个面板都占内存）
set -g history-limit 50000

tmux set-environment -g OPENAI_API_KEY "$OPENAI_API_KEY"

# ——— AI agent 专用区块 ———
set -g extended-keys on
set -g extended-keys-format csi-u   # tmux >= 3.5
set -sg escape-time 10
set -g focus-events on
set -g set-clipboard on
set -g set-titles on
set -g set-titles-string "#S | #T"
setw -g automatic-rename off
set -g remain-on-exit on
set -g detach-on-destroy off
set -g status-interval 5
set -g status-right "#(~/bin/pi-status) | %H:%M"

scp ~/tmux-tutorial.md ~/tmux-tutorial.html you@server:~/

cat ~/tmux-tutorial.md | ssh you@server 'cat > ~/tmux-tutorial.md'
cat ~/tmux-tutorial.html | ssh you@server 'cat > ~/tmux-tutorial.html'