Terminal Integration

The recommended workflow: your agent or shell on the left, Mutsumi on the right.

tmux (Recommended)

Quick script

bash scripts/tmux-dev.sh

This 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-project

Manual

tmux new-session -d -s dev
tmux split-window -h -p 30 "mutsumi"
tmux select-pane -t 0
tmux attach -t dev

In 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

1. Cmd+D to split vertically
2. Right pane: mutsumi
3. Left pane: your agent / shell

Zellij

zellij action new-pane -d right -- mutsumi

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.

Demo

# Run the demo script to see live-reload in action
bash scripts/demo.sh