https://github.com/flplima/tmuxy
The missing tmux GUI. Not a terminal emulator.
https://github.com/flplima/tmuxy
terminal terminal-emulator tmux
Last synced: about 1 month ago
JSON representation
The missing tmux GUI. Not a terminal emulator.
- Host: GitHub
- URL: https://github.com/flplima/tmuxy
- Owner: flplima
- License: mit
- Created: 2026-01-06T17:11:30.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-05-10T13:27:02.000Z (about 2 months ago)
- Last Synced: 2026-05-10T15:12:23.967Z (about 2 months ago)
- Topics: terminal, terminal-emulator, tmux
- Language: TypeScript
- Homepage: http://tmuxy.sh/
- Size: 4.84 MB
- Stars: 31
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: docs/SECURITY.md
Awesome Lists containing this project
README
> [!WARNING]
> *This project is under active development. Not ready for production. See [docs/SECURITY.md](docs/SECURITY.md).*
# tmuxy
The missing tmux GUI you didn't know you needed.
## why?
tmux is the best tool for agent-driven development, but it lacks a good UX.
**tmuxy** fixes that by adding an interface layer with a smoother UX on top of tmux, accessible from anywhere.
- **Agent-friendly**: AI agents already love tmux. Why create a new tool? Instead, tmuxy offers a better UI to watch them in their work.
- **Beginner-friendly**: Do you know what ` %` does? Me neither! tmuxy won't judge you for using the mouse and the system menus.
- **Mobile-friendly**: Combines the tmux power of detachable sessions with the convenience of the browser. Start something on your laptop, pick it up from your phone. No app required. (but a VPN is highly recommended)
- **Web-friendly**: Built on web technologies to unlock richer interfaces. Pane group tabs, pane floats, image rendering, markdown preview, while behind the scenes it's still tmux!
## how it works
A Rust backend connects to tmux via [control mode](https://github.com/tmux/tmux/wiki/Control-Mode) and streams the terminal state to the frontend.
There are two ways to use tmuxy: the **Web App mode** and the **Desktop App mode**.
In the web app, communication happens via HTTP/SSE. It is fast, I promise you. But it's even faster if you use the desktop app (built with Tauri), that skips the network layer and talks to the same Rust core through IPC.
```
┌──────────────┐
│ tmux │
│(control mode)│
└──────┬───────┘
│
┌──────▼───────┐
│ rust backend │
└─┬──────────┬─┘
HTTP IPC
│ │
┌──────▼────┐ ┌───▼───────┐
│ browser │ │ tauri app │
└───────────┘ └───────────┘
```
## install (macOS)
```bash
brew install --cask flplima/tap/tmuxy
```
The desktop app is unsigned (no Apple Developer subscription), so the
cask runs `xattr -dr com.apple.quarantine /Applications/tmuxy.app`
automatically on install to skip the macOS Sequoia
"Apple could not verify…" dialog.
If you grabbed the DMG directly from the [Releases page](https://github.com/flplima/tmuxy/releases) instead, run that yourself before launching:
```bash
xattr -dr com.apple.quarantine /Applications/tmuxy.app
```
## getting started (development)
```bash
git clone github.com/flplima/tmuxy.git
cd tmuxy
npm run devcontainer
# I strongly recommend using the devcontainer, unless you don't mind
# messing with your host tmux sessions while vibe coding
# From here, ask your AI agent for help.
# Good luck!
```
## license
[MIT](LICENSE)