
# Muxflow
**Remote-first tmux IDE for coding agents.**
[](./LICENSE)
[](#install)
[](#install)
[](#install)
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.
|
 |
|
### 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.
|
 |
|
### 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.
|
 |
|
### 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.
|
 |
|
### 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).
|
 |
|
### 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.
|
 |
|
### Voice mode
Hold to talk to an agent from your phone. Replies come back as voice messages, walkie-talkie style.
|
 |
|
### Cross platform
macOS, Linux, and Android. iOS is coming soon.
|
 |
## 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