Mutsumi 是布局无关的 —— 她是一个独立的终端进程,不关心你如何排列窗口。以下是推荐的集成方式。
tmux 分屏(推荐)
Section titled “tmux 分屏(推荐)”左侧运行你的 Agent,右侧运行 Mutsumi:
如果你克隆了 Mutsumi 仓库:
bash scripts/tmux-dev.sh# 创建新的 tmux 会话tmux new-session -d -s dev
# 右侧 30% 区域运行 Mutsumitmux split-window -h -p 30 "mutsumi"
# 选择左侧面板tmux select-pane -t 0
# 附加到会话tmux attach -t dev现在在左侧面板正常使用你的 Agent。每次 Agent 写入 mutsumi.json,右侧面板的 Mutsumi 都会即时更新。
完整的端到端搭建指南(含一键启动脚本),请查看 工作流 SOP。
tmux 常用操作
Section titled “tmux 常用操作”| 按键 | 操作 |
|---|---|
| Ctrl+b % | 垂直分屏 |
| Ctrl+b “ | 水平分屏 |
| Ctrl+b ←/→ | 在面板间切换 |
| Ctrl+b z | 最大化/恢复当前面板 |
| Ctrl+b d | 断开会话(后台运行) |
tmux attach -t dev | 重新连接到会话 |
iTerm2 分屏
Section titled “iTerm2 分屏”适用于 macOS 的 iTerm2 用户:
- Cmd+D —— 垂直分屏
- 右侧面板:运行
mutsumi - 左侧面板:运行你的 Agent 或 Shell
iTerm2 快捷键
Section titled “iTerm2 快捷键”| 按键 | 操作 |
|---|---|
| Cmd+D | 垂直分屏 |
| Cmd+Shift+D | 水平分屏 |
| Cmd+[ / Cmd+] | 在面板间切换 |
| Cmd+Shift+Enter | 最大化/恢复面板 |
Zellij
Section titled “Zellij”# 打开新标签页zellij action new-tab
# 或在现有布局中分屏zellij action new-pane --direction right -- mutsumi如果你有多个显示器,最简单的方式是在一个终端窗口中运行 Mutsumi,放在副屏上:
# 终端窗口 1(副屏)mutsumi --path ~/project/mutsumi.json
# 终端窗口 2(主屏)# 你的正常工作流...- Mutsumi 放右侧/副屏 —— 她是视觉锚点,适合”瞥一眼”而非持续操作
- 给她 30-40% 的宽度 —— 足够显示标题和状态
- 不要关闭她 —— 让她一直运行,随时可以一键查看/勾选
- 使用 tmux 会话 —— 断开/重连不会丢失状态