AIコーディングエージェント向けの縦タブと通知機能を備えたGhosttyベースのmacOSターミナル
English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ | Українська
通知リングコーディングエージェントがあなたの注意を必要とするとき、ペインに青いリングが表示され、タブが点灯します |
|
通知パネル保留中のすべての通知を一か所で確認、最新の未読にジャンプ |
|
アプリ内ブラウザagent-browserから移植されたスクリプタブルなAPIで、ターミナルの横にブラウザを分割表示 |
|
縦タブ + 横タブサイドバーにgitブランチ、リンクされたPRのステータス/番号、作業ディレクトリ、リッスン中のポート、最新の通知テキストを表示。水平・垂直に分割可能。 |
|
SSHcmux ssh user@remote でリモートマシン用のワークスペースを作成。ブラウザペインはリモートネットワーク経由でルーティングされるため、localhostがそのまま動作します。リモートセッションに画像をドラッグするとscpでアップロードされます。
|
|
Claude Code Teamscmux claude-teams でClaude Codeのチームメイトモードをワンコマンドで実行。チームメイトはネイティブ分割として生成され、サイドバーのメタデータと通知が表示されます。tmuxは不要です。
|
|
`.dmg`ファイルを開き、cmuxをアプリケーションフォルダにドラッグしてください。cmuxはSparkle経由で自動更新されるため、ダウンロードは一度だけで済みます。
### Homebrew
```bash
brew tap manaflow-ai/cmux
brew install --cask cmux
```
後で更新する場合：
```bash
brew upgrade --cask cmux
```
初回起動時、macOSが確認済みの開発者からのアプリを開くことの確認を求める場合があります。**開く**をクリックして続行してください。
## なぜcmux？
私はClaude CodeとCodexのセッションを多数並列で実行しています。Ghosttyで大量の分割ペインを使い、エージェントが私を必要としているときを知るためにmacOSのネイティブ通知に頼っていました。しかし、Claude Codeの通知本文はいつも「Claude is waiting for your input」というコンテキストのないものばかりで、タブを十分に開くとタイトルすら読めなくなっていました。
いくつかのコーディングオーケストレーターを試しましたが、そのほとんどがElectron/Tauriアプリで、パフォーマンスが気になりました。また、GUIオーケストレーターはそのワークフローに縛られるため、単純にターミナルのほうが好みです。そこで、cmuxをSwift/AppKitのネイティブmacOSアプリとして構築しました。ターミナルレンダリングにはlibghosttyを使用し、テーマ、フォント、カラーは既存のGhostty設定を読み込みます。
主な追加機能はサイドバーと通知システムです。サイドバーには、各ワークスペースのgitブランチ、リンクされたPRのステータス/番号、作業ディレクトリ、リッスン中のポート、最新の通知テキストを表示する縦タブがあります。通知システムはターミナルシーケンス（OSC 9/99/777）を検出し、Claude Code、OpenCodeなどのエージェントフックに接続できるCLI（`cmux notify`）を備えています。エージェントが待機中のとき、そのペインに青いリングが表示され、サイドバーのタブが点灯するので、分割やタブをまたいでどれが私を必要としているかがわかります。Cmd+Shift+Uで最新の未読にジャンプします。
アプリ内ブラウザには[agent-browser](https://github.com/vercel-labs/agent-browser)から移植されたスクリプタブルなAPIがあります。エージェントはアクセシビリティツリーのスナップショットを取得し、要素参照を取得し、クリック、フォーム入力、JSの評価が可能です。ターミナルの横にブラウザペインを分割し、Claude Codeに開発サーバーと直接やり取りさせることができます。
すべてがCLIとsocket APIを通じてスクリプタブルです — ワークスペース/タブの作成、ペインの分割、キーストロークの送信、ブラウザでのURL表示。
## The Zen of cmux
cmuxは開発者のツールの使い方を規定しません。ターミナルとブラウザにCLIがあり、あとはあなた次第です。
cmuxはソリューションではなくプリミティブです。ターミナル、ブラウザ、通知、ワークスペース、分割、タブ、そしてそのすべてを制御するCLIを提供します。cmuxはコーディングエージェントの使い方を強制しません。プリミティブで何を構築するかはあなた次第です。
優れた開発者は常に自分のツールを構築してきました。エージェントとの最適な作業方法はまだ誰も見つけていませんし、クローズドな製品を作っているチームも見つけていません。自分のコードベースに最も近い開発者が最初に見つけるでしょう。
100万人の開発者にコンポーザブルなプリミティブを与えれば、どんなプロダクトチームがトップダウンで設計するよりも速く、最も効率的なワークフローを集合的に見つけ出すでしょう。
## ドキュメント
cmuxの設定方法の詳細は、[ドキュメントをご覧ください](https://cmux.com/docs/getting-started?utm_source=readme)。
## キーボードショートカット
### ワークスペース
| ショートカット | アクション |
|----------|--------|
| ⌘ N | 新規ワークスペース |
| ⌘ 1–8 | ワークスペース1–8にジャンプ |
| ⌘ 9 | 最後のワークスペースにジャンプ |
| ⌃ ⌘ ] | 次のワークスペース |
| ⌃ ⌘ [ | 前のワークスペース |
| ⌘ ⇧ W | ワークスペースを閉じる |
| ⌘ ⇧ R | ワークスペースの名前を変更 |
| ⌥ ⌘ E | ワークスペースの説明を編集 |
| ⌘ B | サイドバーの表示切替 |
| ⌥ ⌘ B | 右サイドバーの表示切替 |
| ⌘ ⇧ E | 右サイドバーのフォーカス切替 |
### サーフェス
| ショートカット | アクション |
|----------|--------|
| ⌘ T | 新規サーフェス |
| ⌘ ⇧ ] | 次のサーフェス |
| ⌘ ⇧ [ | 前のサーフェス |
| ⌃ Tab | 次のサーフェス |
| ⌃ ⇧ Tab | 前のサーフェス |
| ⌃ 1–8 | サーフェス1–8にジャンプ |
| ⌃ 9 | 最後のサーフェスにジャンプ |
| ⌘ W | サーフェスを閉じる |
### 分割ペイン
| ショートカット | アクション |
|----------|--------|
| ⌘ D | 右に分割 |
| ⌘ ⇧ D | 下に分割 |
| ⌥ ⌘ ← → ↑ ↓ | 方向でペインにフォーカス |
| ⌘ ⇧ H | フォーカス中のパネルを点滅 |
### ブラウザ
ブラウザの開発者ツールのショートカットはSafariのデフォルトに従い、`設定 → キーボードショートカット`でカスタマイズできます。
⌃ P を含むコマンドパレットのナビゲーションショートカットもカスタマイズ可能で、クリアしてキー入力をアクティブなターミナルに届かせることもできます。
| ショートカット | アクション |
|----------|--------|
| ⌘ ⇧ L | 分割でブラウザを開く |
| ⌘ L | アドレスバーにフォーカス |
| ⌘ [ | 戻る |
| ⌘ ] | 進む |
| ⌘ R | ページを再読み込み |
| ⌥ ⌘ I | 開発者ツールの表示切替（Safariデフォルト） |
| ⌥ ⌘ C | JavaScriptコンソールを表示（Safariデフォルト） |
### 通知
| ショートカット | アクション |
|----------|--------|
| ⌘ I | 通知パネルを表示 |
| ⌘ ⇧ U | 最新の未読にジャンプ |
| ⌥ ⌘ U | 現在の項目の未読状態を切替 |
| ⌃ ⌘ U | 現在の項目を最も古い未読としてマークし、次の最新の未読にジャンプ |
### 検索
| ショートカット | アクション |
|----------|--------|
| ⌘ F | 検索 |
| ⌘ ⇧ F | ディレクトリ内を検索 |
| ⌘ G / ⌥ ⌘ G | 次を検索 / 前を検索 |
| ⌥ ⌘ ⇧ F | 検索バーを非表示 |
| ⌘ E | 選択範囲で検索 |
### ターミナル
| ショートカット | アクション |
|----------|--------|
| ⌘ K | スクロールバックをクリア |
| ⌘ C | コピー（選択時） |
| ⌘ V | ペースト |
| ⌘ + / ⌘ - | フォントサイズを拡大 / 縮小 |
| ⌘ 0 | フォントサイズをリセット |
### ウィンドウ
| ショートカット | アクション |
|----------|--------|
| ⌘ ⇧ N | 新規ウィンドウ |
| ⌘ ⇧ O | 前のセッションを再度開く |
| ⌘ , | 設定 |
| ⌘ ⇧ , | 設定を再読み込み |
| ⌘ Q | 終了 |
## ナイトリービルド
[cmux NIGHTLYをダウンロード](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos.dmg)
cmux NIGHTLYは独自のバンドルIDを持つ別のアプリなので、安定版と並行して実行できます。最新の`main`コミットから自動的にビルドされ、独自のSparkleフィード経由で自動更新されます。
ナイトリーのバグは[GitHub Issues](https://github.com/manaflow-ai/cmux/issues)または[Discordの#nightly-bugs](https://discord.gg/xsgFEVrWCZ)で報告してください。
## セッション復元
終了すると、cmuxは現在のセッションを保存します。再起動時にcmuxはアプリが管理する状態を復元します：
- ウィンドウ/ワークスペース/ペインのレイアウト
- 作業ディレクトリ
- ターミナルのスクロールバック（ベストエフォート）
- ブラウザのURLとナビゲーション履歴
cmuxは任意のライブプロセス状態をチェックポイントしません。tmux、vim、シェル、未対応のターミナルアプリは通常のターミナルとして再度開きます。
対応エージェントのセッションは、フックがネイティブセッションIDを保存している場合に復元できます。エージェントのバイナリが`PATH`に乗るよう、エージェントCLIをインストールした後にフックをインストールしてください：
```bash
cmux hooks setup
cmux hooks setup codex
cmux hooks setup --agent opencode
```
`cmux hooks setup`は見つかった対応エージェントをインストールし、スキップしたエージェントのサマリーを表示します。対応する復元連携には、Claude Code、Codex、Grok、OpenCode、Pi、Amp、Cursor CLI、Gemini、Rovo Dev、Copilot、CodeBuddy、Factory、Qoderが含まれます。Claude Codeは、設定でClaude連携が有効な場合、cmuxのClaudeラッパーが処理します。
上級ユーザーや連携機能は、現在のターミナルサーフェスにカスタム復元コマンドを紐づけられます。tmuxセッションやカスタムエージェントCLIのように、独自の永続状態を持つツールに使います：
```bash
cmux surface resume set --kind tmux --checkpoint work --shell "tmux attach -t work"
cmux surface resume show --json
cmux surface resume clear --checkpoint work
```
この紐づけはcmuxサーフェスに保存され続けます。公開CLIやsocketで作成された紐づけは、署名済みのコマンドプレフィックスを自動復元用に承認しない限り、確認と手動復元用に保存されます。承認済みプレフィックスは、存在する場合、作業ディレクトリと正確な環境変数の値にも紐づけられます。承認の確認や編集は**設定 > ターミナル > 復元コマンド**で行えます。cmuxが自動実行するのは、実行中プロセスから検出したtmux紐づけやユーザーが承認したプレフィックスなど、信頼済みとして扱う復元紐づけだけです。トークン、パスワード、シークレット、APIキーなどの機密環境変数キーは、復元紐づけを保存する前に破棄されます。
復元されたエージェントターミナルの復元コマンドを自動実行せずアイドル状態にしておきたい場合は、**設定 > ターミナル > 再オープン時にエージェントセッションを復元**をオフにするか、`~/.config/cmux/cmux.json`に次を設定してください：
```json
{
"terminal": {
"autoResumeAgentSessions": false
}
}
```
これはエージェントの自動復元コマンドのみを無効にします。cmuxは引き続き、保存されたレイアウト、作業ディレクトリ、スクロールバック、ブラウザ履歴を復元します。
最後に保存したスナップショットを手動で再適用する必要がある場合は、次を使用してください：
- `ファイル > 前のセッションを再度開く`
- `⌘ ⇧ O`
- `cmux restore-session`
内部的には、cmuxは`~/Library/Application Support/cmux/`の下にバージョン管理されたスナップショットを書き込み、エージェントフックは`~/.cmuxterm/`の下にセッションマッピングを書き込みます。復元時、cmuxはまずレイアウトを再構築し、その後、自動エージェント復元が有効な場合に対応エージェントのネイティブ復元コマンドを実行します。
完全なガイドは
WeChat: QRコードをスキャンしてコミュニティに参加してください。
