Introduction

TUIOS (Terminal UI Operating System) runs many shells inside one terminal. Each shell gets its own window. You arrange windows with tiling or by hand, group them into nine workspaces, and detach and come back later without losing anything.

Install

brew install tuios

yay -S tuios-bin

curl -fsSL https://raw.githubusercontent.com/Gaurav-Gosain/tuios/main/install.sh | bash

go install github.com/Gaurav-Gosain/tuios/cmd/tuios@latest

Nix, Docker, release binaries and building from source are covered in Getting Started.

Run it

tuios

Press n to open a window, i to type in it, and Alt+Esc to get back to window management. Ctrl+P opens the command palette, which lists every command. Getting Started walks through the rest.

What you get

Windows and layout

• Two modes, modelled on vim: window management mode for arranging windows, terminal mode for typing into one.
• BSP tiling by default, with explicit splits, preselection, swapping and resizing. Master-stack and a niri-style scrolling layout are one palette command away.
• Nine workspaces, zoom, minimize, layout templates and optional shared borders.
• A command palette (Ctrl+P) and an app launcher (Alt+Space).

Sessions

• A daemon owns the shells, so detaching costs nothing and several terminals can attach to one session at once.
• Window layout and working directories come back after a daemon restart or a reboot. Running programs and scrollback do not. See Sessions.
• Sessions and single panes can live on other machines, reached over ssh.

Scripting

• A JSON control protocol on the daemon socket, with blocking waits and an event stream.
• CLI commands for the same things: send-text, capture-pane, wait-for, new-window and more.
• Tape scripts to record and replay workflows, and hooks that run shell commands on window, session and agent events.
• Panes that run coding agents report whether the agent is working, idle or waiting for you.

Terminal

• Vim-style copy mode over 10,000 lines of scrollback per window, plus mouse wheel scrolling and selection.
• Kitty graphics (including mpv --vo=kitty video), sixel passthrough, the kitty keyboard protocol and synchronized output.
• 342 built-in themes with a live picker, and an in-app settings page.

Remote access

• tuios ssh serves TUIOS over SSH with public key authentication.
• tuios-web, a separate binary, serves it to a browser. See Web Terminal.

Where to go next

Community

• Source, issues and discussions: Gaurav-Gosain/tuios on GitHub.
• License: MIT.