ターミナル統合

概要

Mutsumi は レイアウト非依存 です。独立したターミナルプロセスとして動作するため、tmux、zellij、iTerm2、マルチモニターなど、お好みのレイアウトで使用できます。

最も一般的な使い方は、左ペインに Agent / シェル、右ペインに Mutsumi です。

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 のレイアウト例

┌──────────────────────────┬────────────────┐
│                          │                │
│   Agent / Shell          │   Mutsumi TUI  │
│                          │                │
│   $ claude               │  [Today] Week  │
│   > Fix the auth bug     │  v HIGH        │
│                          │  [ ] Fix auth  │
│                          │  v NORMAL      │
│                          │  [ ] Write docs│
│                          │                │
└──────────────────────────┴────────────────┘

iTerm2

Cmd+D でウィンドウを垂直分割
右ペインで mutsumi を実行
左ペインで Agent / シェルを使用

zellij

zellij run -- mutsumi

または手動でペインを分割：

Ctrl+P でペインモードに入る
d で右に分割
右ペインで mutsumi を実行

複数プロジェクトの監視

複数の mutsumi.json を同時に監視することも可能です：

mutsumi --path ~/project-a/mutsumi.json --path ~/project-b/mutsumi.json

TUI にプロジェクトディメンションが追加されます。

推奨セットアップ

ユースケース	推奨レイアウト
単一プロジェクト + Agent	tmux 左 70% シェル / 右 30% Mutsumi
複数プロジェクト	tmux 上下分割 + Mutsumi で複数パス監視
普段使い（Agent なし）	Mutsumi 単体で全画面、CLI でタスク管理