ターミナル統合
Mutsumi は レイアウト非依存 です。独立したターミナルプロセスとして動作するため、tmux、zellij、iTerm2、マルチモニターなど、お好みのレイアウトで使用できます。
最も一般的な使い方は、左ペインに Agent / シェル、右ペインに Mutsumi です。
tmux(推奨)
Section titled “tmux(推奨)”Mutsumi リポジトリに含まれるスクリプトを使用:
bash scripts/tmux-dev.sh-
新しい tmux セッションを作成
Terminal window tmux new-session -d -s dev -
右ペインに Mutsumi を起動(幅 30%)
Terminal window tmux split-window -h -p 30 "mutsumi" -
左ペインを選択
Terminal window tmux select-pane -t 0 -
セッションにアタッチ
Terminal window tmux attach -t dev
tmux new-session -d -s dev && tmux 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 のレイアウト例”┌──────────────────────────┬────────────────┐│ │ ││ Agent / Shell │ Mutsumi TUI ││ │ ││ $ claude │ [Today] Week ││ > Fix the auth bug │ v HIGH ││ │ [ ] Fix auth ││ │ v NORMAL ││ │ [ ] Write docs││ │ │└──────────────────────────┴────────────────┘iTerm2
Section titled “iTerm2”- Cmd+D でウィンドウを垂直分割
- 右ペインで
mutsumiを実行 - 左ペインで Agent / シェルを使用
zellij
Section titled “zellij”zellij run -- mutsumiまたは手動でペインを分割:
- Ctrl+P でペインモードに入る
dで右に分割- 右ペインで
mutsumiを実行
複数プロジェクトの監視
Section titled “複数プロジェクトの監視”複数の mutsumi.json を同時に監視することも可能です:
mutsumi --path ~/project-a/mutsumi.json --path ~/project-b/mutsumi.jsonTUI にプロジェクトディメンションが追加されます。
推奨セットアップ
Section titled “推奨セットアップ”| ユースケース | 推奨レイアウト |
|---|---|
| 単一プロジェクト + Agent | tmux 左 70% シェル / 右 30% Mutsumi |
| 複数プロジェクト | tmux 上下分割 + Mutsumi で複数パス監視 |
| 普段使い(Agent なし) | Mutsumi 単体で全画面、CLI でタスク管理 |