**エージェント時代のための汎用 Rust ターミナルマルチプレクサ。デタッチ可能、スクリプト可能、検査可能で、tmux 互換 CLI、デーモンベースの SDK、ネイティブ [Ratatui](https://ratatui.rs) 統合を備えています。** [English](README.md) · [Français](README.fr.md) · [简体中文](README.zh-CN.md) · 日本語 [![License: MIT OR Apache-2.0](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg)](LICENSE-MIT) [![Release validation](https://github.com/Helvesec/rmux/actions/workflows/ci.yml/badge.svg)](https://github.com/Helvesec/rmux/actions/workflows/ci.yml) [![rmux 0.3.1](https://img.shields.io/badge/rmux-0.3.1-informational.svg)](#install) [![Platform: Linux | macOS | Windows](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)](#platform-support) [![Unsafe policy](https://img.shields.io/badge/unsafe-restricted-success.svg)](#verification)

> [!IMPORTANT] > 現在のリリースは **v0.3.1**、公開日は **2026年5月25日**。tmux 互換の 90 コマンドはすべて実装済みですが、まだ新しい公開プレビューのため不具合が残る可能性があります。問題は [issues](https://github.com/helvesec/rmux/issues) へ報告できます。 ## RMUX を選ぶ理由 RMUX は、tmux の使い道にはまだ十分に掘り下げられていない部分がある、という考えから生まれました。最初の動機は単純でした。SSH 越しに長時間動くエージェントを実行し、そのターミナルを失わずに、周囲の状態を検査し、スクリプト化し、編成したかったのです。そこで、その考えを Rust でゼロから作り直しました。超高速な tmux 互換マルチプレクサ、型付き SDK、永続セッション、構造化スナップショット、そして Linux、macOS、Windows のネイティブなローカルトランスポートを備えています。Windows Named Pipes も含みます。 RMUX はエージェント、ヘッドレス CLI ワークフロー、人間のどれにも使えます。ターミナルアプリにデタッチ可能な実行を与え、あとから再接続し、状態を検査し、コードから操作できます。あるいは、普通の tmux 風ターミナル作業にもそのまま使えます。 ## デモ RMUX を何に使えるかを示す短い実例です。

_{マルチエージェント編成}
_{約 514 行}

_{Agent Broadcast Arena}
_{約 2,171 行}

_Mini-Zellij
_{約 944 行}

_{ターミナル <> ブラウザミラーリング}
_{約 649 行}

_{Playwright テスト}
_{約 1,495 行}

## インストール macOS と Linux のビルド済みバイナリ： ```sh curl -fsSL https://rmux.io/install.sh | sh ``` Windows PowerShell のビルド済みバイナリ： ```powershell irm https://rmux.io/install.ps1 | iex ``` 直接ダウンロードと SHA256 チェックサムは [v0.3.1 GitHub Release](https://github.com/helvesec/rmux/releases/tag/v0.3.1) で確認できます。 Cargo で crates.io から： ```sh cargo install rmux --locked ``` ローカル checkout から： ```sh cargo install --path . --locked ``` Rust アプリケーション向け： ```sh cargo add rmux-sdk cargo add ratatui-rmux ``` ## ドキュメント RMUX の完全なドキュメントは [rmux.io/docs](https://rmux.io/docs/) で確認できます。 [インストールガイド](https://rmux.io/docs/get-started/)、[CLI リファレンス](https://rmux.io/docs/cli/)、[SDK サンプル](https://rmux.io/docs/examples/)、[ターミナル自動化サンプル](https://rmux.io/docs/examples/#/terminal-playwright)、[API ドキュメント](https://rmux.io/docs/api/) を含みます。 ## CLI クイックスタート ```sh rmux new-session -d -s work rmux split-window -h -t work rmux send-keys -t work 'echo "hello from rmux"' Enter rmux attach-session -t work ``` ローカルのコマンドヘルプ： ```sh rmux list-commands rmux new-session --help rmux split-window --help ``` ## SDK クイックスタート ```toml [dependencies] rmux-sdk = "0.3" tokio = { version = "1", features = ["rt-multi-thread", "macros"] } ``` ```rust use std::time::Duration; use rmux_sdk::{ EnsureSession, EnsureSessionPolicy, Rmux, SessionName, TerminalSizeSpec, }; #[tokio::main] async fn main() -> rmux_sdk::Result<()> { let rmux = Rmux::builder() .default_timeout(Duration::from_secs(5)) .connect_or_start() .await?; let session_name = SessionName::new("work").expect("valid session name"); let session = rmux .ensure_session( EnsureSession::named(session_name) .policy(EnsureSessionPolicy::CreateOrReuse) .detached(true) .size(TerminalSizeSpec::new(120, 32)), ) .await?; let pane = session.pane(0, 0); pane.send_text("printf 'ready\\n' && sleep 1\n").await?; pane.wait_for_text("ready").await?; let snapshot = pane.snapshot().await?; println!("{}x{}", snapshot.cols, snapshot.rows); Ok(()) } ``` ## Ratatui ウィジェット ```rust use ratatui::{buffer::Buffer, layout::Rect, widgets::Widget}; use ratatui_rmux::{PaneState, PaneWidget}; use rmux_sdk::PaneSnapshot; fn render(snapshot: PaneSnapshot, area: Rect, buffer: &mut Buffer) { let state = PaneState::from_snapshot(snapshot); PaneWidget::new(&state).render(area, buffer); } ``` ## アーキテクチャ

3つの公開インターフェイス — `rmux` CLI、`rmux-sdk` Rust crate、`ratatui-rmux` ウィジェット — は、デーモンと通信するための単一のローカルプロトコルを共有します。1つのインターフェイスでできることは、他のインターフェイスでもできます。 ## ワークスペース | Crate | 役割 | 公開 | | :--- | :--- | :--- | | `rmux-types` | 共有されるプラットフォーム非依存の低レベル値型 | 公開 | | `rmux-proto` | 分離式 IPC DTO、フレーミング、wire-safe なエラー | 公開 | | `rmux-os` | 小さな OS 境界ヘルパー | 公開 | | `rmux-ipc` | ローカル IPC エンドポイントとトランスポート | 公開 | | `rmux-sdk` | デーモンベースの Rust SDK | 公開 | | `ratatui-rmux` | Ratatui 統合ウィジェット | 公開 | | `rmux-pty` | PTY 割り当て、resize、子プロセス制御 | サポート crate | | `rmux-core` | session、pane、layout、format、hook、buffer | サポート crate | | `rmux-server` | Tokio デーモンとリクエスト dispatch | サポート crate | | `rmux-client` | ローカル IPC client と attach plumbing | サポート crate | | `rmux` | CLI と隠しデーモンエントリポイント | 公開バイナリ | | `rmux-render-core` | 共有 snapshot レンダリングコア | ワークスペース内部 | ## プラットフォームサポート | プラットフォーム | PTY バックエンド | IPC バックエンド | デフォルトエンドポイント | | :--- | :--- | :--- | :--- | | Linux | Unix PTY | Unix socket | `/tmp/rmux-{uid}/default` | | macOS | Unix PTY | Unix socket | `/tmp/rmux-{uid}/default` | | Windows | ConPTY | Named pipe | ユーザーごとの named pipe | ## 設定 Linux と macOS では、RMUX は標準の system/user locations から `.rmux.conf` を読み込みます： 1. `/etc/rmux.conf` 2. `~/.rmux.conf` 3. `$XDG_CONFIG_HOME/rmux/rmux.conf` 4. `~/.config/rmux/rmux.conf` Windows でも RMUX は `.rmux.conf` を読み込みます。探索場所は次の通りです： 1. `%XDG_CONFIG_HOME%\rmux\rmux.conf` 2. `%USERPROFILE%\.rmux.conf` 3. `%APPDATA%\rmux\rmux.conf` 4. `%RMUX_CONFIG_FILE%` ### `tmux.conf` 移行フォールバック RMUX がデフォルトの設定探索で起動し、RMUX 設定ファイルが1つも読み込まれなかった場合、移行用にフィルタ済みの `tmux.conf` を読み込めます。`-f` で設定ファイルを明示した場合、このフォールバックは使われません。フォールバックの探索場所： - Linux と macOS：`/etc/tmux.conf`、`~/.tmux.conf`、`$XDG_CONFIG_HOME/tmux/tmux.conf`、`~/.config/tmux/tmux.conf` - Windows：`%XDG_CONFIG_HOME%\tmux\tmux.conf`、`%USERPROFILE%\.tmux.conf`、`%APPDATA%\tmux\tmux.conf` 読み込み対象は意図的に絞っています。RMUX はサポート済みの静的オプションとキー割り当ての解除だけを取り込み、 tmux のキーバインド、環境変数や端末機能の変更、プラグイン用ユーザーオプション、hooks、シェルコマンド、コマンドブロック、条件ブロック、`#(cmd)` のようなフォーマットジョブ、再帰的な `source-file` エントリ、未サポートのオプションは実行せずにスキップします。完全に無効化するには `RMUX_DISABLE_TMUX_FALLBACK=1` を設定してください。フォールバックファイルは可能な範囲で読み込まれ、通常ファイルではないものと 1 MiB を超えるものは無視されます。 ### ターミナル互換性のメモ RMUX は、fish のようにターミナル機能を問い合わせる shell と連携できます。端末属性問い合わせに応答し、Escape キーのタイミングも扱うため、RMUX pane 内でも fish のプロンプトやキーシーケンスが通常どおり動作します。 Kitty graphics passthrough は、Kitty graphics protocol をサポートする外側のターミナルで利用できます。対象には Kitty、Ghostty、WezTerm が含まれます。これは明示的に有効化します： ```tmux set -g allow-passthrough on ``` ターミナルが Kitty graphics をサポートしているのに自動検出されない場合は、 terminal feature override を追加してください： ```tmux set -as terminal-features 'xterm-kitty:kitty-graphics' ``` Windows では、OS が対応していれば RMUX は modern ConPTY passthrough を有効にします。診断のためにこの backend mode を無効化するには `RMUX_CONPTY_NO_PASSTHROUGH=1` を設定してください。 ## 検証このワークスペースは、ロックされた依存関係を使ってソースから検証できるように設計されています： ```sh cargo fmt --all -- --check cargo clippy --workspace --all-targets --locked -- -D warnings cargo test --workspace --locked --no-fail-fast ``` 追加のローカルチェック： ```sh scripts/cfg-check.sh scripts/unsafe-check.sh scripts/no-network-in-runtime.sh scripts/check-platform-neutrality.sh scripts/ratatui-rmux-budget.sh scripts/verify-package.sh ``` リリースアーティファクトのチェックは次のスクリプトで実行されます： ```sh scripts/release-local.sh scripts/package-unix.sh ``` 上位 crate では `#![forbid(unsafe_code)]` を使用しています。OS とターミナル境界のコードは低レイヤーのランタイム crate に隔離されています。 ## ライセンス RMUX は次のいずれかのライセンスで利用できます： - [MIT License](LICENSE-MIT) - [Apache License 2.0](LICENSE-APACHE)