Gaurav-Gosain/tuios v0.2.1 on GitHub

TUIOS v0.2.1 Release

Highlights

This release brings major improvements to theming, terminal compatibility, and window management. TUIOS now supports 340+ color themes with adaptive terminal colors, better cross-platform PTY handling, and enhanced window manipulation with viewport bounds checking.

Features

Adaptive Theme System

TUIOS now includes 340+ beautiful color themes from Gogh, iTerm2, and custom sources. Themes affect not just the UI, but also the terminal's color palette - so applications like ls, vim, htop, and cava will use your theme colors instead of hardcoded defaults.

New commands:

tuios --theme <name> - Select a theme (default: tokyonight)
tuios --list-themes - Browse all available themes
tuios --preview-theme <name> - Preview theme colors with hex values

Popular themes include: tokyonight, dracula, nord, gruvbox, catppuccin, monokai, solarized, github, and one_dark.

# Interactive selection
tuios --theme $(tuios --list-themes | fzf --preview 'tuios --preview-theme {}')

Enhanced Theme Color Support

The terminal emulator now intelligently routes ANSI colors through the theme system. Base colors (0-15) use your selected theme, while extended colors (16-255) and RGB colors pass through unchanged. This gives you consistent theming without breaking applications that use precise colors.

Viewport Bounds Checking

Windows can no longer be dragged or resized beyond the screen edges. This prevents:

Windows disappearing off-screen with negative coordinates
Windows overlapping with the dock area
ANSI color corruption at viewport boundaries
Accidentally losing track of windows

The window management feels more polished and prevents common frustration points.

Better Cross-Platform Terminal Support

Switched from go-pty to charmbracelet/x/xpty for improved Windows ConPTY support and better compatibility across platforms. This also fixes issues with shells like fish that require the PTY to be set as the controlling terminal.

Graceful Shutdown

TUIOS now properly handles SIGINT/SIGTERM signals and cleans up the terminal state on exit:

Resets terminal modes (mouse tracking, focus reporting, alternate screen)
Restores cursor visibility
Prevents prompt corruption

Your terminal will be left in a clean state whether you exit normally or via Ctrl+C.

Performance

Background windows now refresh at 30Hz (up from 20Hz) for smoother animations while focused windows maintain 60Hz.

Documentation

The documentation has been significantly expanded:

Added comprehensive theme color architecture guide with diagrams
New theming section in CLI reference with examples
Fixed navigation action names and added cross-references between docs
Clarified system internals and component responsibilities

Bug Fixes

Fixed Windows build compatibility by using platform-specific PTY setup
Fixed shell startup issues where processes weren't getting PTY as controlling terminal
Fixed windows immediately disappearing after spawn
Fixed ANSI color corruption at viewport edges
Fixed terminal state not being properly reset on exit

Breaking Changes

None. All changes are backward compatible 🎉

Upgrade Notes

Simply update to v0.2.1. No configuration changes required. The default theme is tokyonight, but you can easily switch:

# Try different themes
tuios --theme dracula
tuios --theme nord
tuios --theme gruvbox_dark

# Make it permanent with a shell alias
alias tuios='tuios --theme nord'

Installation

Quick Install (Linux/macOS)

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

Homebrew (macOS/Linux)

brew tap Gaurav-Gosain/tap
brew install tuios

Arch Linux (AUR)

# Using yay
yay -S tuios-bin

# Using paru
paru -S tuios-bin

Nix

# Run directly
nix run github:Gaurav-Gosain/tuios#tuios

# Or add to your configuration
nix-shell -p tuios

Manual Download

Download the appropriate binary for your platform below, extract it, and run:

./tuios

Go Install

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

Contributors

Gaurav Gosain (@Gaurav-Gosain)
ShalokShalom (@ShalokShalom)

Full Changelog: v0.1.0...v0.2.1