Gaurav-Gosain/tuios

▲ 1,756 stars today★ 6,196⑂ 290

A terminal window manager that knows what your agents are doing. Tiling panes, workspaces, sessions that survive restarts, and one Inbox for every coding agent.

About Gaurav-Gosain/tuios

Gaurav-Gosain/tuios is an open-source project on GitHub, mainly written in Go. A terminal window manager that knows what your agents are doing. Tiling panes, workspaces, sessions that survive restarts It currently holds 6,196 stars and 290 forks with 39 open issues, and was last pushed on 2026-10-29 (repository created 2025-09-06).

Project Overview

Git Homed tracks it on the Today's Trending board.

GitHub Repository Details

Repository Gaurav-Gosain/tuios · default branch main · size 95398 KB · watchers 15 · source: GitHub REST API and repository README

README

https://github.com/Gaurav-Gosain/tuios/blob/HEAD/tuios: a terminal window manager that knows what your agents are doing. Tilly, a small purple CRT whose screen is a tiled layout, stands beside the tuios wordmark and a tiled terminal session.

TUIOS: Terminal UI Operating System

https://github.com/Gaurav-Gosain/tuios/blob/HEAD/Latest Release https://github.com/Gaurav-Gosain/tuios/blob/HEAD/GoDoc https://github.com/Gaurav-Gosain/tuios/blob/HEAD/Ask DeepWiki
https://github.com/Gaurav-Gosain/tuios/blob/HEAD/Terminal Trove Tool of The Week

https://github.com/Gaurav-Gosain/tuios/blob/HEAD/TUIOS

TUIOS is a modern terminal multiplexer and window manager built with Go. It provides a vim-like modal interface with multiple terminal panes, workspaces, BSP tiling, kitty graphics protocol support, and a command palette, all running inside your existing terminal. A daemon keeps sessions alive, reaches sessions on your other machines, and lets the coding agents in your panes report their state and message each other.

Built on the Charm stack (Bubble Tea v2, Lipgloss v2), TUIOS features event-driven rendering for near-zero idle CPU usage, flicker-free kitty image passthrough, and comprehensive keyboard/mouse interaction.

Documentation

Full documentation is available at tuios.dev (hosted) or in the docs/ folder. To try tuios without installing it, take the guided tour at tuios.dev/learn: the real app, compiled to WebAssembly, with a practice shell in every pane.

What changed in v0.10.1 is in the release notes.

Quick Links

Table of Contents

Installation

Package Managers

Homebrew (macOS/Linux):

brew install tuios

Homebrew, ghostty build (Linux only): tuios built with the libghostty-vt emulator. It installs a binary with the same name as the tuios formula. Uninstall the formula first.

brew uninstall tuios
brew install gaurav-gosain/tap/tuios-ghostty

Arch Linux (AUR):

yay -S tuios-bin

Nix:

nix run github:Gaurav-Gosain/tuios/v0.10.1#tuios   # a release
nix run github:Gaurav-Gosain/tuios#tuios          # the latest main
nix run nixpkgs#tuios                             # the nixpkgs package

Put a release tag after the repo name to build that release. Without a tag, Nix builds the newest commit on main.

Other Methods

# Quick install script (Linux/macOS, and Windows from Git Bash or PowerShell with WSL)
curl -fsSL https://raw.githubusercontent.com/Gaurav-Gosain/tuios/main/install.sh | bash

Go install

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

Docker

docker run -it --rm ghcr.io/gaurav-gosain/tuios:latest

GitHub Releases: Pre-built binaries for Linux, macOS, Windows, FreeBSD and OpenBSD, with a checksums.txt. The tuios-ghostty_* archives are tuios built on the libghostty-vt emulator, for Linux, macOS and Windows on amd64 and arm64.

Building from source needs Go 1.26.8 or newer.

Updating. If you installed with the quick install script or a release binary, tuios update fetches the newest release and puts it in place (tuios update --check just reports). Everything else has a package manager that owns the binary, so use that instead; tuios update detects which you have and prints the right command rather than overwriting it.

Shell Completions

tuios completion prints a completion script for bash, zsh, fish or PowerShell. Besides subcommands and flags, it completes values such as session names for --session and configured hosts for --host.

# Bash (needs the bash-completion package)
tuios completion bash > ~/.local/share/bash-completion/completions/tuios

Zsh (the directory must be on your $fpath, before compinit runs)

tuios completion zsh > "${fpath[1]}/_tuios"

Fish

tuios completion fish > ~/.config/fish/completions/tuios.fish
# PowerShell: add this line to your $PROFILE
tuios completion powershell | Out-String | Invoke-Expression

Start a new shell afterwards. Run tuios completion --help for more options, or see the CLI reference.

Requirements: A terminal with true color support. Kitty graphics and sixel support recommended (Ghostty, Kitty, WezTerm).

Features

TUIOS
https://github.com/Gaurav-Gosain/tuios/blob/HEAD/tuios with four tiled panes: a git diff, a Go file, test output and a build. The sidebar lists the session, its files and four agents with their states.
Panes and the rail. Tiled panes, and every agent's state at a glance.
https://github.com/Gaurav-Gosain/tuios/blob/HEAD/The tuios Inbox listing an approval marked risky, a question and an errored agent, with the reason the approval is risky.
The Inbox. Everything your agents wait on, in one list.
https://github.com/Gaurav-Gosain/tuios/blob/HEAD/The tuios review view: a file list on the left and a highlighted diff on the right, with keys for notes, hunks and files.
Review. Read an agent's changes and send notes back to it.
https://github.com/Gaurav-Gosain/tuios/blob/HEAD/The tuios settings page searched for theme. The Theme row carries a dot because it differs from the default.
Settings. Every option on one page, applied at once.

Each picture is a capture that tuios made of itself. Click one to read its docs page.

Core

Agents

The guide is docs/AGENT_STATE.md.

Machines

Tiling

Scrollback & Copy Mode

Graphics & Protocols

Session Management

Automation

Discovery & Navigation

More

Quick Start

tuios                    # Launch TUIOS
tuios --show-keys        # Launch with key overlay for learning
tuios --standalone       # Launch without the daemon, for this run only

tuios attaches to a daemon-backed session, so the session outlives the terminal window it started in. New panes are tiled. See SESSIONS.md to turn either off.

Essential Keys

| Key | Action | |-----|--------| | Ctrl+P | Command palette: search and run any action | | Alt+Space | Launcher: search and start a program (Enter runs it, Tab types it out) | | n | New pane (Window Management mode) | | i / Enter | Enter Terminal mode | | Prefix+Esc or Alt+Esc | Back to Window Management mode (a bare Esc goes to the shell) | | Prefix+d | Detach in a daemon session, otherwise back to Window Management mode | | z (WM) or Prefix+z | Toggle pane zoom | | Prefix+Space | Toggle BSP tiling | | Prefix+ | Enter copy mode (vim scrollback) | | Prefix+S | Session switcher | | Prefix+L then l/s | Load/Save layout template | | Prefix+? | Help overlay | | Prefix+q | Quit |

The prefix key is Ctrl+B by default (configurable).

Daemon Mode

tuios new mysession          # Create persistent session
tuios attach mysession       # Reattach
tuios ls                     # List sessions
tuios kill-session mysession # Kill session

Layout Templates

# In-app: Ctrl+B, L, l to load / Ctrl+B, L, s to save

Or via command palette: Ctrl+P → "Save layout" / "Load layout"

CLI:

tuios layout list # List saved layouts tuios layout delete mysetup # Delete a layout tuios layout export mysetup # Export as tape script

Configuration

tuios config edit            # Edit config in $EDITOR
tuios keybinds list          # View the common keybindings

See the [configuration reference (or run tuios list-options) for all options including show_clock, show_cpu, show_ram, shared_borders, window_button_style, window_button_position, custom themes, and keybinding customization.

Architecture

TUIOS follows the Model-View-Update pattern on Bubble Tea v2. For details, see Architecture Guide.

Key design decisions:

Core Components:

Performance

Development

git clone https://github.com/gaurav-gosain/tuios.git
cd tuios
go build -o tuios ./cmd/tuios
./tuios

To install a local build on your PATH instead, ./scripts/install.sh builds and installs into ~/.local/bin. I

GitHub Stars & Activity

6,196Stars
290Forks
39Open issues
GoLanguage

GitHub Popularity

GitHub stars6,196
Forks290
Open issues39
Primary languageGo
LicenseMIT
Stars gained today1,756
Created2025-09-06
Last pushed2026-10-29

Trending History

Monthly boardrank #93 · ▲ 1,756 stars

Related GitHub Projects

1

avelino / awesome-go

Go★ 192,000⑂ 13,698▲ 192 stars
→
2

JuliusBrussee / caveman

Go★ 117,367⑂ 6,812▲ 266 stars
→
3

multica-ai / multica

Go★ 54,861⑂ 7,224▲ 128 stars
→
4

vxcontrol / pentagi

Go★ 33,249⑂ 5,188▲ 133 stars
→
5

gastownhall / beads

Go★ 28,479⑂ 1,922▲ 42 stars
→
6

keploy / keploy

Go★ 19,335⑂ 2,448▲ 221 stars
→
7

CarterPerez-dev / Cybersecurity-Projects

Go★ 9,045⑂ 1,336▲ 44 stars
→
8

Asymptote-Labs / agent-beacon

Go★ 3,261⑂ 288▲ 193 stars
→

More Trending Repositories