第1層クライアント
デスクトップアプリ、タブレットのブラウザ、またはAndroidアプリ。クライアントはホストの記録・認証情報・決定ログを保存するだけで、エージェントは実行しません。
AgentMuxは、リモートホストと手元のPCで動くAIコーディングエージェント(Claude Code、Codex、Gemini CLI、Grok CLI、Aiderなど)を管理するアプリです。各エージェントはホスト上のtmuxセッション内で動作するため、クライアントを閉じても、ノートPCをスリープさせても、ネットワークが切れても作業は中断しません。タブレットやスマホからも利用できます。
AgentMuxはエージェントのプロセスを自身では動かしません。ホスト上のtmuxセッションに接続し、エージェントはそのセッション内で動くため、クライアントの接続状態は作業に影響しません。
デスクトップアプリ、タブレットのブラウザ、またはAndroidアプリ。クライアントはホストの記録・認証情報・決定ログを保存するだけで、エージェントは実行しません。
ホストごとにSSH接続を1本だけ確立します。ターミナル、コマンド、ファイル転送はこの接続を共有するため、複数のターミナルを開いても認証は1回です。ローカルホストはsshdなしで直接接続します。
エージェントはホスト上のtmuxセッション内で動作します。クライアントを閉じても、PCがスリープしても、ネットワークが切れてもセッションは動き続け、クライアントを開き直すと同じpaneに再接続します。スクロールバックも残っています。
AgentMuxはエージェントのプロセスを自身では動かさず、ホスト上のtmuxセッションに接続します。セッションが生きているかどうかはクライアントとは無関係です。
クライアントの切断、ノートPCのスリープ、ネットワーク断の間もエージェントは動き続けます。クライアントを開き直すと同じpaneに再接続し、スクロールバックもすべて残っています。長時間のタスクが1本のSSH接続に依存しなくなります。
各エージェントのpaneは、色・マウス・選択・検索に対応した完全なターミナルです。途中で入力してエージェントを修正し、タスクを再起動せずに制御を戻せます。
ターミナル領域は最大9ペインまで分割可能 — ホストをまたぐ3×3のウォールを、それぞれ独立して操作できます。境界をドラッグしてリサイズ、タブをダブルクリックでズーム。レイアウトはウィンドウに追従し、次回起動時に復元されます。
1つの指示を選択した複数のエージェントに送信します。各エージェントが送達確認を返すので、一括操作の結果をエージェントごとに確認できます。
ローカルのOllamaモデルに目標(例:あるエージェントが止まっている原因の調査)を与え、ツール呼び出しを1回ずつ進めます。書き込み操作はすべて一時停止してあなたの承認を待ち、定期巡回は読み取り専用です。
プロジェクトの事実、好み、エージェントの活動をインデックス化し、語句でも意味でも検索できます。埋め込みはローカルで計算され、データがマシンの外に出ることはありません。既知のパターンに一致する認証情報は、保存前にマスキングされます。
同じバイナリをヘッドレスで動かせば、タブレットのブラウザでターミナル・エージェント・ツールボックス・ファイルブラウザを含む完全なAgentMuxが使えます。Androidにはコアを内蔵した単体アプリもあり、SSH接続はデバイスから直接行うため、常時起動のマシンは不要です。
これまでツリー上のエージェントの状態は「実行中」だけでした。現在は各paneを定期的に読み取り、質問中・完了して確認待ち・プロンプトで待機中に分類します。対応が必要なエージェントはツリー上で強調表示され、確認すると消えます。
起動時と6時間ごとに新しいリリースを確認し、ダウンロード、sha256の検証、その場での置き換えと再起動を行います。失敗時は自動でロールバックします。設定全体を暗号化ファイルとして書き出し、別のPCに読み込めます。読み込みで既存の項目が上書きされることはありません。
以下はすべてアプリケーションのスクリーンショットです。
任意のエージェントのtmuxペインにアタッチ。フルカラー、マウスレポート、検索、選択に対応します。サイドパネルにはプロセスの状態、直近の出力、ライフサイクル操作が並びます。

同じ指示を、プロジェクトやホストをまたいで選択したエージェントに送信します。各エージェントが送達確認を返すため、届いたかどうかを1つずつ確認できます。

インストールパネルはまずホストを検査し、実際にサポートできるエージェントCLIとランタイムだけを提示します。利用できないものは理由付きで示されます。インストールはtmux内で実行されるため、接続が切れても中途半端なパッケージツリーが残ることはありません。

既定ではAppleのシステムカラーを使い、ほかにNord、Solarizedなど6種類のテーマ(ライトモード含む)があります。情報密度は長時間の監視向けに調整しています。

デスクトップアプリに加えて、使い方が2つあります。ヘッドレスのserveモードでは任意のブラウザが完全なクライアントになり、Androidにはコアを内蔵した単体アプリがあります。どちらも同じフロントエンドと同じコアで動き、機能はデスクトップ版と同じです。
リリースにはサーバー専用ビルド agentmux-server-linux-{amd64,arm64} が付属します。完全な静的バイナリで、GTKもWebViewもディスプレイも不要 — 任意のLinuxサーバーにコピーして起動するだけ。デスクトップ版は --serve で同じモードに入ります。初回起動時にアクセストークンが生成されログに出力されます(データディレクトリの serve-token に保存、AGENTMUX_TOKEN で上書き可)。
タブレットで http://ホスト:8642 を開き、トークンを一度入力すれば、ターミナル、エージェント、ツールキット、ファイル閲覧のすべてが使えます。iPadはSafariの「共有 → ホーム画面に追加」、AndroidはChromeの「ホーム画面に追加」で単体アプリに。ブラウザを閉じても何も止まりません — デスクトップの窓を閉じるのと同じで、エージェントはリモートのtmuxの中で生きています。
各リリースに agentmux-android.apk(Android 8.0+ · arm64)が付属します。サーバー版と同一のコアを内蔵し、フォアグラウンドサービスとして起動 — 画面ロック後もAndroidに凍結されず、SSHは端末から直接、設定と鍵は端末内に残ります。小さな画面向けにレイアウトも作り直しました。768px未満ではサイドパネルがオーバーレイのドロワーになり、画面下のナビゲーションバーがツリー、コマンドパレット、詳細、設定を親指の届く位置に置きます(セーフエリア対応)。
デスクトップアプリ、ヘッドレスserve、Androidアプリは同じコアを使います。違いはコアが動く場所です。
| デスクトップアプリ | ヘッドレスserve | Androidアプリ | |
|---|---|---|---|
| コアの実行場所 | あなたのPC | 任意のLinuxマシン | デバイス自体 |
| 常時稼働のマシン | 不要 | 必要(サーバー) | 不要 |
| 使い方 | デスクトップのウィンドウ | 任意のブラウザ:iPad、Androidタブレット、スマホ | ネイティブアプリ、フォアグラウンドサービスで常駐 |
| 状態の保存先 | ローカルSQLite | サーバー上、全クライアントで共有 | デバイス内 |
| 認証 | システムのキーチェーン | アクセストークン。インターネット越しならHTTPSを前段に | デバイス内 |
| ダウンロード | agentmux-macos / windows / linux | agentmux-server-linux-{amd64,arm64} | agentmux-android.apk |
タブレットとスマホ対応のほか、8月のリリースには次の機能が含まれます。
ターミナルが回線を失っても作業は終わっていません — 向こう側のtmuxセッションは動き続けています。パイプは同じshell id、同じスクロールバック、同じペインで張り直され、待機は1秒から15秒へと伸び、約5分後には従来の手動ボタンが残ります。TCPとSSHの2つのkeepaliveはそれぞれ別の問いに答えます。一度きりのコマンド端末は対象外です — Wi-Fiが瞬断しただけでインストールをやり直すのは誰も望まないからです。
画面が必要な作業もあります。ホストを右クリックすると3389と5900が、そのホストが既に張っているSSH接続を通ってこのPCへ転送され、このPCにあるビューア(リモートデスクトップ接続 / 画面共有 / Remmina)に渡されます。ループバックだけを待ち受けるデスクトップでも、ネットワークに何も開ける必要はありません。
起動直後と6時間ごとにリリースを確認し、新しい版があればタイトルバーの下に1行のバナーが出ます:更新して再起動、リリースノート、あとで。更新は進捗バー付きでダウンロードし、公開されたsha256を検証して実行ファイルを置き換え、失敗すれば動作していたビルドへ戻します。
ホスト、フォルダ、プロジェクト、ワークスペース、エージェント定義をパスフレーズで暗号化した1つのファイルに書き出し(Argon2id + AES-256-GCM)、別のPCで開きます。インポートは決して上書きしません:同じアドレスのホスト、同じ名前のプロジェクト、同じマシンの同じパスはそのまま残るので、同じファイルを二度取り込んでも何も増えません。
メトリクスパネルは稼働状況だけでなく、CPUのモデル名、メモリモジュールの仕様、物理ドライブ、グラフィックスアダプタも表示します。これらは静的な情報なので、3秒ごとのポーリングではなく、セッション内でキャッシュされる一度きりの読み取りで取得します。
ワンクリックインストールにGrok CLI、Docker(6通りの方法。ネットワークが必要とする場合はミラーで再試行し、最後にデーモンを起動してユーザーをグループに追加)、Ollamaが加わりました。UIには繁體中文が追加 — 台湾の用語で書き起こした完全な辞書であり、簡体字からの文字変換ではありません。
以下の制約は設定項目ではなく設計上の決定で、その多くは無効化できません。
パスワードと鍵のパスフレーズはAES-256-GCMで暗号化してから保存され、暗号鍵はOSのキーチェーン(Keychain、資格情報マネージャー、Secret Service)に置かれます。キーチェーンが使えない場合はパーミッション0600のファイルにフォールバックし、その旨がステータスバーに表示されます。
ホストキーは初回接続時にピン留めされます。以降に不一致が起きると、理由の説明とともに接続を中止します — 中間者攻撃によるすり替えが黙って通ることはありません。
シークレットがUIプロセスに渡ることはありません。インターフェイスが知り得るのは「設定されているかどうか」だけで、値そのものは決して見えません。
オーケストレーターが呼び出せるのは固定のホワイトリストにあるツールのみで、各ツールには宣言時に固定されたリスク階層が付きます。実行は、階層・ホストの信頼レベル・実行トリガーを組み合わせた単一のゲートを通過します。
スケジュール実行のパトロールでは、読み取り以外のツールはすべて無条件に拒否され、この制限は設定で変更できません。パトロールは停滞したエージェントを報告できますが、それに対処する権限は持ちません。
すべての実行の全ステップが記録されます — 拒否・却下・未回答のまま残った提案も含めて。リモートの出力はデータとしてマークされてモデルに渡され、指示のように見えるテキストには承認カード上でフラグが立ちます。
AgentMuxのアーキテクチャは次の4つの原則に基づいています。
AgentMuxはホスト上のtmuxセッションに接続し、エージェントのプロセスを自身では動かしません。クライアントを終了しても実行中のタスクには影響しません。
バイナリ1つとSQLiteデータベース1つ。アカウント、デーモン、バックエンドサービスは不要で、ホスト情報はあなたのPCにだけ保存されます。
オーケストレーターは調査と提案を行い、ホストを変更する操作はすべてあなたの確認を必要とします。無人の巡回は読み取り専用の操作に限定されます。
埋め込みはローカルで計算し、秘密情報はUIプロセスに渡しません。エージェントはホストからモデル提供元に直接接続し、AgentMuxはその通信を中継せず、APIキーも読みません。
移行、リファクタリング、大規模なテストなど、1営業日や1回のネットワーク接続より長く続くタスク。
3台から50台のホストで動くエージェントを1つのツリーに表示し、各エージェントの状態と最新の出力を確認できます。
1回の操作で複数のエージェントに指示を送り、それぞれから送達確認を受け取ります。
インストールコマンドを手で組み立てずに、インストールパネルから新しいホストを使える状態にします。
定期的な読み取り専用の巡回で、止まっているエージェントを報告します。変更は行いません。
計画、埋め込み、メモリはすべてローカルで動作します。エージェントのモデル通信は中継せず、APIキーも読みません。
Unix系のリモートホストに必要なのはtmuxとSSHアカウントだけ — tmuxがなければAgentMuxが インストールできます。リモートWindowsホストはOpenSSH Serverを有効にするだけです。手元のPCはさらに簡単で、認証情報は一切不要です。
ドキュメントを読む→リモート:アドレス、ユーザー、そしてssh-agent/鍵ファイル/パスワードのいずれか。踏み台(ジャンプホスト)にも対応。ローカル:名前を付けるだけです。
そのホスト上の作業ディレクトリを指定します。あるいはホストのファイルをブラウズして、その場でディレクトリを追加 — 名前・パス・ホストはすでに分かっています。
名前と起動コマンドを指定します。Startを押せば、ホスト上のtmux内で稼働が始まります。
claude --dangerously-skip-permissionsエージェントへのアタッチ、シェルを開く、CLIのインストール、テーマの変更 — そのすべてへの最短経路です。
Ctrl / ⌘ + Kすべてタグ付きコミットからGitHub Actionsが生成し、各ファイルに.sha256が付属します。
任意のLinux · amd64とarm64 · GTK/WebView・ディスプレイ不要
agentmux-server-linux-amd64.tar.gz
agentmux-server-linux-arm64.tar.gz
xattr -dr com.apple.quarantine)。
Windowsでは「詳細情報 → 実行」を選択します。
curl -L -O でダウンロードすれば、macOSの隔離属性を回避できます。
いいえ。目的、プロンプト、リポジトリの規約はすべてあなたのものです。オーケストレーターは調査と提案を行うだけで、ホストを変更する操作は明示的な承認後にのみ実行されます。
リモートのUnix系ホスト(Linux / macOS)にはPOSIXシェル、tmux、SSHが必要です(tmuxがなければAgentMuxがインストールできます)。リモートWindowsホストはOpenSSH Serverを有効にするだけ — セッションはAgentMux内蔵のセッションデーモンが担い、初回利用時にSFTPで自動配備されます。手元のマシンはLinuxとmacOSではそのまま利用できます。Windowsでは同じマシンが2つのローカルホストを提供します — tmuxが動くWSLディストリビューションと、ネイティブWindows(PowerShell。同じデーモンで永続化されるため、ウィンドウを閉じてもネイティブの作業は止まりません)。
いいえ。Ollama(チャットモデル1つと埋め込みモデル1つ)が必要なのは、ローカルオーケストレーションとセマンティックメモリ検索だけです。なくても、他の機能はすべて利用できます。
いいえ — これは意図的な設計です。エージェントの通信は、ホストから各エージェントCLIに設定されたプロバイダへ直接送られます。AgentMuxはそれをプロキシせず、キーも読み取らないため、コストの集計も予算の強制もできません。
1インストールにつきオペレーターは1人です。状態、認証情報、意思決定ログはワークステーション上に保存されます — 共有サーバーもチームアカウントも中央監査基盤もありません。2人が同じフリートを操作すると、同じtmuxセッションを見ることになりますが、履歴はそれぞれ別に保持されます。
止まりません。ワークスペースやエージェントのレコードを削除しても、消えるのはローカルの記録だけで、tmuxセッションは動き続けます。実行中のセッションを破棄する唯一の操作はKillという名前で、何が失われるかを提示して必ず事前に確認します。
2通りあります。1つはヘッドレスサーバーを任意のLinuxで動かす方法(専用の agentmux-server-linux-{amd64,arm64}、またはデスクトップ版に --serve)。タブレットで http://ホスト:8642 を開いてトークンを一度入力し、「ホーム画面に追加」すれば単体アプリになります — iPadはこちらです。もう1つはAndroidで agentmux-android.apk を直接インストールする方法で、コアを内蔵しているためサーバーは一切不要です。
serveモードではコアがあなたのどこかのマシンで動き、タブレットはクライアントです。そのためスマホ・タブレット・デスクトップが同じ状態を共有します。APKはコアを端末そのものに載せます:SSHはスマホから直接発行され、設定と鍵は端末内に残り、常時起動のマシンは関係しません。フォアグラウンドサービスは意図的なものです — これがないと画面ロック後にAndroidがプロセスを凍結し、すべてのSSH接続が切れてしまいます。
認証はアクセストークンのみです(初回起動時に生成され、データディレクトリの serve-token に保存されます)。LANやVPN内なら十分ですが、インターネット越しに使う場合は平文HTTPを直接晒さず、HTTPSのリバースプロキシを前段に置いてください。