https://github.com/yugo-ibuki/unitmux
"unitmux" — Unifies your AI coding sessions into a single floating interface.
https://github.com/yugo-ibuki/unitmux
agent claude-code multi-agent terminal tmux vim
Last synced: 3 months ago
JSON representation
"unitmux" — Unifies your AI coding sessions into a single floating interface.
- Host: GitHub
- URL: https://github.com/yugo-ibuki/unitmux
- Owner: yugo-ibuki
- Created: 2026-03-13T16:07:24.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-31T08:56:57.000Z (3 months ago)
- Last Synced: 2026-04-02T05:56:18.519Z (3 months ago)
- Topics: agent, claude-code, multi-agent, terminal, tmux, vim
- Language: TypeScript
- Homepage: https://unitmux.vercel.app/
- Size: 1.74 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.ja.md
Awesome Lists containing this project
README
# unitmux
複数の AI コーディングセッションを一つのフローティング UI に統合します。
[English](README.md)
## どんなアプリ？
unitmux は常に最前面に表示される小さなウィンドウで、tmux 内で動作中の AI コーディングアシスタント（`claude`、`codex`）すべてに接続します。コマンド送信、ステータス確認、選択肢の応答 — すべてを一箇所から、ターミナルを切り替えずに。
## 必要なもの
- macOS
- [tmux](https://github.com/tmux/tmux) で `claude` または `codex` が動作していること
## インストール
### Homebrew（推奨）
```bash
brew install --cask yugo-ibuki/tap/unitmux
```
### 手動インストール
[Releases](https://github.com/yugo-ibuki/unitmux/releases) ページから最新のDMGをダウンロードし、アプリを `/Applications` にドラッグしてください。
### macOS Gatekeeper の警告
初回起動時、公証されていないためmacOSがアプリをブロックすることがあります。
**システム設定 → プライバシーとセキュリティ** を開き、下部の「このまま開く」をクリックしてください。
## 使い方
1. tmux ペインで `claude` または `codex` を起動する
2. unitmux を開く — AI ペインが自動的に検出される
3. 上部のタグからペインを選択する
4. メッセージを入力して `Cmd+Enter` で送信（設定で `Enter` に変更可能）
### ペインバッジ
各ペインタグには実行中のツールを示すバッジが表示されます：**CC**（Claude Code）は青、**CX**（Codex）は緑。
### ステータス表示
| 表示 | 意味 |
| ---------------- | --------------------------------- |
| 緑のドット | 入力受付中 |
| オレンジのドット | 処理中 |
| グレーのドット | 応答待ち — 選択ボタンが表示される |
### AI が質問してきたとき
`claude` や `codex` が番号付き選択肢（例：「1. Yes / 2. No」）を表示すると、ペインタグの横にクリック可能なボタンが現れます。クリックするだけで即座に応答できます。
### キーボードショートカット
| ショートカット | アクション |
| --------------------------- | --------------------------------------------------------------------------------- |
| `Cmd+Enter` または `Enter` | 入力を送信（設定で変更可能） |
| `Cmd+↑` | 前のペインに切り替え |
| `Cmd+↓` | 次のペインに切り替え |
| `Ctrl+1-9` | 番号付き選択肢を直接送信（修飾キーは設定で変更可能） |
| `Ctrl+H` / `Ctrl+L` | 前 / 次のペインに切り替え |
| `Ctrl+Cmd+H` / `Ctrl+Cmd+L` | 前 / 次のセッションにジャンプ |
| `Ctrl+P` | ペイン内容のプレビュー表示 / ライブストリーミング切り替え（キーは設定で変更可能） |
| `Ctrl+N` | 新しいセッションを作成（tmuxセッションとコマンドを選択） |
| `Ctrl+D` | セッション詳細ポップアップを表示（キーは設定で変更可能） |
| `Ctrl+C` | セッションを終了（詳細パネル表示中、確認ダイアログあり） |
| `Ctrl+G` | git操作ポップアップを表示（キーは設定で変更可能） |
| `Ctrl+F` | git diffビューアーを表示（キーは設定で変更可能） |
| `Ctrl+S` | セッションの実行を停止 — Escapeを送信して中断（キーは設定で変更可能） |
| `Ctrl+W` | コンパクトモード切り替え — タブバーだけの細い表示に（キーは設定で変更可能） |
| `Ctrl+N` | 新しいセッションを作成（tmuxセッションとコマンドを選択） |
| `/` | スラッシュコマンドの補完を表示（入力先頭で） |
| `Ctrl+C` | セッションを終了（詳細パネル表示中、確認ダイアログあり） |
| `↑` / `↓` | 入力履歴をたどる |
| `Cmd+Shift+H` | どのアプリからでもunitmuxにフォーカス（キーは設定で変更可能） |
| `Escape` | ポップアップを閉じる / テキストエリアにフォーカス |
ポップアップではvim風の操作が使えます：`j`/`k`（スクロール）、`d`/`u`（半ページ）、`g`/`G`（先頭/末尾）、`q`（閉じる）
ペインプレビュー（`Ctrl+P`）は末尾から表示され、Claudeの最後の応答が青いアクセントボーダーでハイライトされます。もう一度 `Ctrl+P` を押すと**ライブストリーミング**が開始され、500msごとにリアルタイムで更新されます（点滅するLIVEバッジ付き）。ポップアップヘッダーの▶/⏸ボタンでも切り替え可能です。ストリーミング中に `j`/`k` でスクロールすると自動スクロールが一時停止し、`G` で最新出力への追従を再開できます。
### セッション詳細
`Ctrl+D` で選択中のペインの詳細を表示：ターゲット、コマンド、モデル、セッションID、PID、CWD、gitブランチ/ステータス。詳細パネルには**セッション終了**ボタンがあり、ペインを閉じることができます。詳細パネル表示中に `Ctrl+C` を押すと、確認ダイアログが表示されます。
### セッション管理
`Ctrl+N` で新しいセッションを作成できます。ダイアログでターゲットのtmuxセッションを選び、`claude` か `codex` のどちらを起動するか選択します。選択したtmuxセッションに新しいウィンドウが作成され、ペインリストが自動更新されます。
### git操作
`Ctrl+G` でペインの作業ディレクトリのgit操作ポップアップを表示。**Add All**、**Commit**（メッセージ入力）、**Push** を直接実行できます。ポップアップ内ショートカット：`Ctrl+A`（add all）、`Ctrl+P`（push）。
### スラッシュコマンド
よく使うテキストをスラッシュコマンドとして保存できます（例：`/fix`、`/review`）。テキストエリアの先頭で `/` を入力すると、フィルター付きの補完リストが表示されます。`Enter`、`Tab`、またはクリックでコマンドの内容を挿入。コマンドの管理はサイドバーの **Slash Commands** セクションから行えます。
### 設定
歯車アイコンをクリックして設定を開けます：
- **常時最前面表示** — ウィンドウを他のウィンドウより手前に固定
- **Opacity** — ウィンドウの透明度を調整（50%〜100%）
- **Font Size** — テキストエリアとプレビューログの文字サイズを調整
- **テーマ** — ダーク / ライトの切り替え
- **Choice Key** — 選択肢ショートカットの修飾キーを変更（`Ctrl` または `Cmd`）
- **Send Key** — 送信キーを `Cmd+Enter` または `Enter` に変更（もう一方が改行になる）
- **Vim Mode** — Claude CLIのvimエディタモード用にEscape+iのインサートモード切り替えを有効化
- **Stop Key** — セッション停止のキーを変更（`Ctrl+<キー>`）
- **Compact Key** — コンパクトモードのキーを変更（`Ctrl+<キー>`）
- **Preview Key** — プレビュー表示のキーを変更（`Ctrl+<キー>`）
- **Detail Key** — セッション詳細のキーを変更（`Ctrl+<キー>`）
- **Git Key** — git操作のキーを変更（`Ctrl+<キー>`）
- **Diff Key** — git diffビューアーのキーを変更（`Ctrl+<キー>`）
- **Focus Key** — unitmuxにフォーカスするグローバルショートカットを変更（`Cmd+Shift+<キー>`）
- **Slash Commands** — スラッシュコマンドの追加・編集・削除
## ライセンス
MIT