Muxflow logo # Muxflow **Remote-first tmux IDE for coding agents.** [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE) [![Linux](https://img.shields.io/badge/Linux-x86__64-informational?logo=linux&logoColor=white)](#install) [![macOS](https://img.shields.io/badge/macOS-Apple_Silicon-informational?logo=apple&logoColor=white)](#install) [![Android](https://img.shields.io/badge/Android-APK-informational?logo=android&logoColor=white)](#install) Play the Muxflow demo video
Agent notifications on desk and phone, voice replies, screenshot paste over SSH, multi-host, ports, files, and Git. ## Features
### tmux based Sessions stay on the host. Close the app, reboot your laptop, or switch machines and every window, pane, and process is still there when you come back. Sessions are workspaces, windows are tabs, and renames flow both ways. Muxflow attached to a remote tmux session: every window and pane is a tmux pane
### Works across SSH Attach to a [remote host](./docs/remote-host.md), Linux or macOS, through your existing OpenSSH config. The helper talks over SSH and a private Unix socket, never a TCP port, and several hosts can be shown [side by side](./docs/multi-host.md). The Ports tab lists what is listening on the host and forwards a port to your machine with one click. Connection settings with an SSH host
### Native paste across SSH Copy a screenshot or a file on your laptop and paste it into a pane on a remote host. Muxflow uploads it over the same SSH connection and drops the path into the terminal, so Codex or Claude Code sees the image as if it were local. Pasting a screenshot into a remote pane; Claude Code sees it as an image
### Files, Git, and Ports Browse, edit, and download files on the host with a Markdown preview; diff, stage, commit, and push; see what is listening on an SSH host and forward a port with one click. File explorer, Git panel and Ports tab on a remote host
### Notifications on desktop and mobile Get told when a Codex, Claude Code or pi agent blocks on a question or finishes, whether you are at the desk or on your phone. Lifecycle comes from reviewable [agent hooks](./docs/agent-hooks.md). An agent notification on Android, opened into the agent's terminal
### Mobile The Android app shows your agents and their state, lets you read an agent's terminal and type a reply, browse files, and start new agents in any workspace. Agents list on the phone
### Voice mode Hold to talk to an agent from your phone. Replies come back as voice messages, walkie-talkie style. Voice mode: hold to talk, the reply comes back as voice
### Cross platform macOS, Linux, and Android. iOS is coming soon. Muxflow
## Supported agents Codex, Claude Code and [pi](https://pi.dev) have lifecycle adapters. Any other CLI agent runs as an ordinary tmux window without attention tracking; add your own with [agent hooks](./docs/agent-hooks.md). ## Install ```sh curl -fsSL https://github.com/gal064/muxflow/releases/latest/download/install.sh | bash ``` Make sure [tmux](https://github.com/tmux/tmux/wiki/Installing) is installed on your machine and on every machine you connect to. For Android, install the APK from the [releases page](https://github.com/gal064/muxflow/releases/latest). ## Connect to a remote machine 1. Make sure tmux 3.3 or newer is installed on the remote machine. 2. Make sure you can run `ssh ` from your terminal without extra flags. Muxflow uses your OpenSSH config, keys, and agent, so an alias in `~/.ssh/config` works too. 3. In Muxflow, click the host name at the bottom left, choose **Connection settings…**, and click **+ Add host**. 4. Select **SSH** and enter the host or config alias in **SSH host**. 5. Click **Check helper**, then **Install helper…** to put the helper in `~/.local/bin` on the remote machine. No root needed. 6. Click **Connect**. Optionally, click **Set up agent status…** to get Codex, Claude Code and pi notifications from that machine. More in [SSH hosts](./docs/remote-host.md). ## Troubleshooting ### Muxflow can't connect to tmux Make sure the latest tmux is installed on your machine and on the machine you're connecting to (3.3 or newer is required). ### Notifications don't appear Open **Settings** and click **Send test notification** under **System notifications**. If nothing appears, check System Settings → Notifications → Muxflow. ### The connection drops or lags 1. Open **Settings**, select the host, and click **Check helper**. If it offers **Install helper…** or **Upgrade helper…**, click it to get the latest helper. 2. Make sure you have a good internet connection and that SSH is available on both your machine and the remote machine. 3. Check CPU usage on the remote machine. High CPU there often causes lag, and it's easy to miss because it happens on the other machine. ### Codex agents show "unknown" Codex 0.157 and newer run a shared background server that hides which pane an event came from. Muxflow starts new tmux panes without it. 1. Start Codex again in a new pane or tab. Codex windows opened before Muxflow connected still use the background server. 2. If you set `CODEX_EXEC_SERVER_URL` yourself, Muxflow leaves it alone and Codex status won't work. More in the [troubleshooting guide](./docs/troubleshooting.md). ## Build from source Requirements: Rust 1.97.1, Node.js 24, pnpm 11, tmux 3.3+, and the [Tauri 2 platform prerequisites](https://v2.tauri.app/start/prerequisites/). ```sh pnpm install --frozen-lockfile pnpm test:transport:local tmux new-session -s work pnpm tauri dev ``` Package builds: `pnpm release:linux -- x86_64`, `pnpm release:macos`, and `pnpm mobile:apk:release`. Details are in the [release guide](./docs/release.md). ## Documentation - [Setup](./docs/setup.md) and [SSH hosts](./docs/remote-host.md) - [Key bindings](./docs/keybindings.md) - [Agent hooks](./docs/agent-hooks.md) - [Automations](./docs/automations.md): scheduled agent runs - [Diagnostics, privacy, and security](./docs/diagnostics-privacy-security.md) - [Privacy policy](./site/privacy/README.md) - [Troubleshooting](./docs/troubleshooting.md) - [Release guide](./docs/release.md) and [test suite](./tests/README.md) - [Historical plans](./docs/history/README.md) ## License Muxflow source is licensed under [MIT](./LICENSE). The bundled JetBrains Mono and Inter fonts retain their own licenses in the desktop and mobile font directories. The optional speech model is downloaded separately; its upstream and conversion model cards are linked in [third-party notices](./docs/third-party.md).