Terminal Integration
The recommended workflow: your agent or shell on the left, Mutsumi on the right.
tmux (Recommended)
Section titled “tmux (Recommended)”bash scripts/tmux-dev.shThis creates a tmux session with your shell on the left and Mutsumi on the right.
Custom session name and width:
MUTSUMI_WIDTH=40 bash scripts/tmux-dev.sh my-projecttmux new-session -d -s devtmux split-window -h -p 30 "mutsumi"tmux select-pane -t 0tmux attach -t devIn the left pane, use your agent normally. Every time the agent writes to mutsumi.json, the right pane updates instantly.
For a complete end-to-end setup guide (including one-click launch scripts), see Workflow SOP.
iTerm2
Section titled “iTerm2”- Cmd+D to split vertically
- Right pane:
mutsumi - Left pane: your agent / shell
Zellij
Section titled “Zellij”zellij action new-pane -d right -- mutsumiGeneral Pattern
Section titled “General Pattern”┌──────────────────────┬──────────────┐│ │ ││ Your shell / │ Mutsumi ││ AI Agent │ TUI ││ │ ││ (writes mutsumi.json) │ (watches) ││ │ │└──────────────────────┴──────────────┘Mutsumi is layout-agnostic — she works in any terminal arrangement. Use tmux, zellij, iTerm2 splits, multiple monitors, or multiple terminal windows.
# Run the demo script to see live-reload in actionbash scripts/demo.sh