Releases: CrystalPlatforms/umux
Release list
umux 1.0.2 — first cross-platform launch
umux 1.0.2 — first cross-platform launch
The 1.0 milestone: umux now ships native Windows and macOS builds alongside Linux, from one codebase.
v1.0.1 was cut minutes before this one and carries Linux and macOS artifacts only — its tag predates a Windows-only compile fix (borrowed tool args in the #42 port-enumeration code, caught by the CI matrix). v1.0.2 is the complete release; prefer it.
Highlights since v0.2.0
- Windows (NSIS
.exe) and macOS (universal.dmg) builds via CI (#33, #34) — per-OS shells and config directories; unsigned-build first-run steps in the README - Terminal tabs inside workspaces (#37): workspaces hold tabs, tabs split into unlimited panels
- Pane zoom — one shortcut fills the tab and back (#40)
- Git branch labels on tab rows (#41)
- Listening-ports tooltip: hover a tab (or a workspace row) to see its listening ports; click a port to copy its
http://localhostURL (#42) - Apple-design polish pass: press feedback, reduced motion, unified chrome (#39)
Install
| Linux | .AppImage / .deb / .rpm |
| macOS | universal .dmg (11+) |
| Windows | NSIS .exe (10+) |
Builds are unsigned (zero-cost policy) — first-run steps for Gatekeeper/SmartScreen are in the README. Telemetry is one anonymous app-open event, nothing else. MIT licensed.
Full changelog: v0.2.0...v1.0.2
umux 1.0.1 — first cross-platform launch
umux 1.0.1 — first cross-platform launch
The 1.0 milestone: umux now ships native Windows and macOS builds alongside Linux, from one codebase.
Highlights since v0.2.0
- Windows (NSIS
.exe) and macOS (universal.dmg) builds via CI (#33, #34) — per-OS shells and config directories; unsigned-build first-run steps in the README - Terminal tabs inside workspaces (#37): workspaces hold tabs, tabs split into unlimited panels
- Pane zoom — one shortcut fills the tab and back (#40)
- Git branch labels on tab rows (#41)
- Listening-ports tooltip: hover a tab (or a workspace row) to see its listening ports; click a port to copy its
http://localhostURL (#42) - Apple-design polish pass: press feedback, reduced motion, unified chrome (#39)
Install
| Linux | .AppImage / .deb |
| macOS | universal .dmg (11+) |
| Windows | NSIS .exe (10+) |
Builds are unsigned (zero-cost policy) — first-run steps for Gatekeeper/SmartScreen are in the README. Telemetry is one anonymous app-open event, nothing else. MIT licensed.
Full changelog: v0.2.0...v1.0.1
umux 0.2.0 — unlimited panels, agent status, settings & session restore
The first feature release of umux — everything you need to run several AI agents side by side and actually see which one needs you.
- Unlimited panels — split any workspace into as many resizable panels as you need (drag the dividers); the layout persists per workspace
- Agent status per panel — a live dot (working / needs your input / idle) for Claude Code, Codex, Gemini CLI and Aider: it knows when a CLI waits for you, holds the dot steady while you click around, and returns to idle when you exit the CLI
- Settings screen — toggle agent status & desktop notifications; choices persist across restarts
- Session restore — reopen umux and your workspaces, panels, layouts, working directories and shells come back
- Safe closing — closing a panel that runs a live process asks first, on every path
- macOS support — universal
.dmg(Apple Silicon + Intel, macOS 11+); config lives in~/Library/Application Support/umux(migrated automatically) - Anonymous install counter — umux reports a single
app_openevent so development is guided by real usage; no terminal content, names, or paths ever leave the machine. Opt out with"analyticsEnabled": falseinsettings.json
Tip for Claude Code users: set
"preferredNotifChannel": "iterm2"in~/.claude/settings.jsonso Claude Code emits the notification signals umux listens for — outside Ghostty/Kitty/iTerm2 it stays silent without it (see the README's Enabling completion signals section).
Install: Linux .deb / .AppImage and the macOS .dmg are attached below. Builds are unsigned (zero-cost policy) — on first run macOS will ask you to confirm (right-click → Open); see the README's first-run notes.
umux 0.1.0 — development preview 5 (ikona wypełnia 94%)
Co nowego względem v0.1.0-dev.4:
- 🎨 Logo powiększone — plik źródłowy logo miał wbudowane przezroczyste marginesy (~35%), przez co znak zajmował tylko ~2/3 ikony. Wycięte marginesy → znak wypełnia teraz 94% ikony aplikacji
Historia poprawek w dev-ach (nadal zawarte):
- dev.2: TERM=xterm-256color w PTY — backspace i
clearna macOS - dev.3: ikona = logo projektu umux
- dev.4: ikona bez tła (przezroczystość)
Znane ograniczenia na macOS (w trakcie prac, issue #32):
- Powiadomienia desktopowe nie działają na Macu (notify-send)
- Konfig w ~/.config/umux zamiast ~/Library/Application Support
?w promptzie zsh = brak Nerd Fontu (kosmetyka)
Instalacja na Macu:
- Otwórz .dmg → przeciągnij umux do Applications → Zamień
- Prawy klik → Open przy pierwszym uruchomieniu
- Stara ikona w Docku?
killall Dockw Terminalu
umux 0.1.0 — development preview 4 (ikona bez tła)
Co nowego względem v0.1.0-dev.3:
- 🎨 Ikona bez tła — poprzednia wersja miała ciemne tło (#212123), które wyglądało jak ciemny kwadrat w Docku. Teraz ikona to czyste logo na przezroczystości — macOS sam daje mu zaokrąglenie i cień
Poprawki z wcześniejszych dev-ów (nadal zawarte):
- TERM=xterm-256color w PTY — backspace i
cleardziałają na macOS (dev.2) - Ikona = logo projektu umux zamiast generatu AI (dev.3)
Znane ograniczenia na macOS (w trakcie prac, issue #32):
- Powiadomienia desktopowe nie działają na Macu (mechanizm jest linuksowy — notify-send)
- Konfig aplikacji ląduje w ~/.config/umux zamiast w ~/Library/Application Support
?w promptzie zsh = brak Nerd Fontu (kosmetyka)
Pierwsze uruchomienie na Macu (build niepodpisany):
- Otwórz .dmg i przeciągnij umux do Applications (podmień starą wersję)
- Przy ostrzeżeniu o nieznanym developercie: prawy klik na umux → Open → Open (jednorazowo)
- Jeśli Dock cache'uje starą ikonę:
killall Dockw Terminalu
umux 0.1.0 — development preview 3 (nowa ikona)
Co nowego względem v0.1.0-dev.2:
- 🎨 Nowa ikona aplikacji — AI-generowana ikona zastąpiona logo projektu umux (widoczna w Docku na macOS, w menu aplikacji i w instalatorach Linux/Windows)
Poprawki z dev.2 (nadal zawarte):
- TERM=xterm-256color w PTY — backspace i
cleardziałają na macOS
Znane ograniczenia na macOS (w trakcie prac, issue #32):
- Powiadomienia desktopowe nie działają na Macu (mechanizm jest linuksowy — notify-send)
- Konfig aplikacji ląduje w ~/.config/umux zamiast w ~/Library/Application Support
?w promptzie zsh = brak Nerd Fontu (kosmetyka)
Pierwsze uruchomienie na Macu (build niepodpisany):
- Otwórz .dmg i przeciągnij umux do Applications (podmień starą wersję)
- Przy ostrzeżeniu o nieznanym developercie: prawy klik na umux → Open → Open (jednorazowo)
💡 Tip: po podmienieniu appki ikona w Docku może jeszcze chwilę pokazywać starą — pomaga przeciągnięcie ikony umux z Applications na Dock (lub restart Docka: killall Dock w terminalu).
umux 0.1.0 — development preview 2 (fix: klawiatura na macOS)
Co naprawiono względem v0.1.0-dev.1 (znalezione na macOS):
- 🐛 Backspace działał jak spacja / dziwne znaki — aplikacja startowana z Findera nie ma zmiennej TERM, przez co powłoka schodziła w tryb awaryjny. Teraz backend ustawia TERM=xterm-256color
- 🐛
clearkrzyczał "TERM environment variable not set" — ten sam powód, naprawione - Suite testów Rust przechodzi teraz na macOS (testy używały /proc i promptu basha)
Znane ograniczenia na macOS (w trakcie prac, issue #32):
- Powiadomienia desktopowe nie działają na Macu (mechanizm jest linuksowy — notify-send)
- Konfig aplikacji ląduje w ~/.config/umux zamiast w ~/Library/Application Support
?w promptzie zsh = brak Nerd Fontu (kosmetyka, czcionka do dobrania w #32)
Pierwsze uruchomienie na Macu (build niepodpisany):
- Otwórz .dmg i przeciągnij umux do Applications (podmień starą wersję)
- Przy ostrzeżeniu o nieznanym developercie: prawy klik na umux → Open → Open (jednorazowo)
Jak sprawdzić poprawkę: w terminalu umux odpal echo $TERM — powinno pokazać xterm-256color; backspace i clear mają działać normalnie.
umux 0.1.0 — development preview (macOS build)
Co nowego w tym buildzie:
- 🆕 Pierwszy build macOS — uniwersalny .dmg (Apple Silicon M1+ oraz Intel w jednym pliku)
- Linux bez zmian (.deb + .AppImage), wersja = v0.1.0
Znane ograniczenia na macOS (w trakcie prac, issue #32):
- Powiadomienia desktopowe nie działają na Macu (mechanizm jest linuksowy — notify-send)
- Konfig aplikacji ląduje w ~/.config/umux zamiast w ~/Library/Application Support
Pierwsze uruchomienie na Macu (build niepodpisany):
- Otwórz .dmg i przeciągnij umux do Applications
- Przy ostrzeżeniu o nieznanym developercie: prawy klik na umux → Open → Open (jednorazowo)
Reszta (terminale, panele, workspaces, split, SSH) powinna działać normalnie.
umux v1 release
Publish first version of umux.
CrystalPlatforms.