terminux¶
A fast, reliable, cross-platform terminal, organized the way you actually work.
Workspaces sit on the left, tabbed terminals in the middle, and everything stays where you left it, even across restarts.

The idea¶
You have several projects on the go: each is a different directory, a different mental context, a different set of running shells. terminux gives each of them a home: a workspace. Workspaces and their tabs persist across restarts, so reopening the app drops you straight back into your layout.
terminux takes the workspace UX of cmux and rebuilds it on a clean, auditable two-process architecture, written in Python, with reliability over features as the guiding principle. There is no account, telemetry, AI, or editor: just a terminal that respects your flow.
Highlights¶
- Workspaces sidebar: a persistent, reorderable list of named workspaces, each with an automatic status dot.
- Tabbed terminals: multiple live PTY shells per workspace; background tabs keep streaming with no switch jank.
- Persistence: workspaces, tabs, window geometry, sidebar state, font size, and per-shell working directories persist across restarts.
- Keyboard-first: workspace jumps, fuzzy quick-switcher, find-in-terminal, font zoom. See Keyboard shortcuts.
- Working vs ready: the sidebar status dot turns amber while a workspace has a foreground task running (green wins when there's unseen output to look at, so the dot reads like a CI traffic light).
- Attention routing: background activity indicators; BEL /
OSC 9on an off-screen tab raises a badge that bubbles up to its workspace. - Remote access: run the backend on a server and connect from your laptop
with
--connect; shells keep running while you disconnect, and terminals reconnect automatically. See Remote access. - Local-first & hardened: loopback-only by default, per-session auth token, CSP and security headers, atomic versioned persistence.
Where to go next¶
- Getting started: install, run, and package terminux.
- Workspaces & tabs: the core model and how persistence behaves.
- Keyboard shortcuts: every binding.
- Architecture: the two-process design.
Status: 0.8 preview
terminux is a 0.8 preview. The workspace + tabbed-terminal core, scrollback
persistence, and remote access (--server / --connect) work well; split
panes and the Windows PTY backend are not done yet. See the FAQ.