muxflow

Name: muxflow
Author: gal064

Pending

Remote-first tmux IDE for coding agents. Agent notifications on desk and phone, voice replies, screenshot paste over SSH, multi-host, ports, files, and Git.

74stars

0forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/gal064/muxflow

Getting Started

Guides for using ai agents skills like muxflow.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Compare with similar skills

See how muxflow compares with popular alternatives.

muxflow vs ecc

See comparison

muxflow vs hermes agent

See comparison

muxflow vs everything claude code

See comparison

README.md

Frequently Asked Questions

What is muxflow?

muxflow is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by gal064. Remote-first tmux IDE for coding agents. Agent notifications on desk and phone, voice replies, screenshot paste over SSH, multi-host, ports, files, and Git. It has 74 GitHub stars.

Is muxflow safe to use?

muxflow's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install muxflow?

Clone the repository with "git clone https://github.com/gal064/muxflow" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is muxflow written in?

muxflow is primarily written in TypeScript. It is open-source under gal064 on GitHub, so you can review or fork the full source.

Are there alternatives to muxflow?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh muxflow against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

275,167

limboo nuphus

Muxflow

Remote-first tmux IDE for coding agents.

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, 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. 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 or Claude Code agent blocks on a question or finishes, whether you are at the desk or on your phone. Lifecycle comes from reviewable agent hooks.

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 and Claude Code have lifecycle adapters. Any other CLI agent runs as an ordinary tmux window without attention tracking; add your own with agent hooks.

Install

curl -fsSL https://github.com/gal064/muxflow/releases/latest/download/install.sh | bash

Make sure tmux is installed on your machine and on every machine you connect to.

For Android, install the APK from the releases page.

Connect to a remote machine

Make sure tmux 3.3 or newer is installed on the remote machine.
Make sure you can run ssh <host> from your terminal without extra flags. Muxflow uses your OpenSSH config, keys, and agent, so an alias in ~/.ssh/config works too.
In Muxflow, click the host name at the bottom left, choose Connection settings…, and click + Add host.
Select SSH and enter the host or config alias in SSH host.
Click Check helper, then Install helper… to put the helper in ~/.local/bin on the remote machine. No root needed.
Click Connect.

Optionally, click Set up agent status… to get Codex and Claude Code notifications from that machine. More in SSH hosts.

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

Open Settings, select the host, and click Check helper. If it offers Install helper… or Upgrade helper…, click it to get the latest helper.
Make sure you have a good internet connection and that SSH is available on both your machine and the remote machine.
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.

Start Codex again in a new pane or tab. Codex windows opened before Muxflow connected still use the background server.
If you set CODEX_EXEC_SERVER_URL yourself, Muxflow leaves it alone and Codex status won't work.

Build from source

Requirements: Rust 1.97.1, Node.js 24, pnpm 11, tmux 3.3+, and the Tauri 2 platform prerequisites.

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.

Documentation

License

Muxflow source is licensed under MIT. 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.