Gaurav-Gosain/tuios v0.0.23 on GitHub

TUIOS v0.0.23 Release

A terminal-based window manager with tmux-style keybindings.

What's New in v0.0.23

This is a major feature release introducing a modern CLI framework, complete TOML configuration system, and several critical bug fixes.

Highlights

Modern CLI with Fang + Cobra: Styled help, subcommands, shell completions
Complete TOML Configuration: Full keybinding customization at ~/.config/tuios/config.toml
Action-Based Input System: Decoupled keybindings with dispatcher pattern
Dynamic Help System: Shows your actual configured keybindings
Multiple Bug Fixes: Log viewer, dock overflow, SSH mode, help search

Breaking Changes

CLI has been restructured to use subcommands:

tuios --config-path → tuios config path
tuios --edit-config → tuios config edit
tuios --list-keybinds → tuios keybinds list
tuios --ssh → tuios ssh

See the CLI Reference for full migration guide.

Installation

Quick Install (Linux/macOS)

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

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.0.23

Shell Completions

Generate completions for your shell:

# Bash
tuios completion bash > /etc/bash_completion.d/tuios

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

# Fish
tuios completion fish > ~/.config/fish/completions/tuios.fish

Documentation

Configuration Guide - TOML config with examples
Keybindings Reference - Complete keybinding list
CLI Reference - All commands and flags
Architecture Guide - Technical details

Changelog

New Features

CLI Migration to Fang + Cobra
- Modern command-line interface with styled help and error messages
- Subcommand structure for better organization
- Shell completion generation for bash, zsh, fish, and powershell
- Man page generation support
TOML Configuration System
- Complete keybinding customization at ~/.config/tuios/config.toml
- Platform-aware defaults with automatic key normalization
- XDG Base Directory specification compliant
- Comprehensive validation with helpful error messages
- Auto-generation of config file with documentation
Action-Based Input System
- Decoupled keybindings from action handlers for better maintainability
- Action dispatcher pattern enables user rebinding without code changes
- Cleaner code organization and improved testability
Dynamic Help System
- Help overlay displays your actual configured keybindings
- Context-aware help for different modes
- Auto-generated from configuration

Bug Fixes

Fixed log viewer scroll overflow and added auto-scroll to newest logs
Fixed dock status bar overflow (now truncates content to fit on one line)
Fixed copy mode mouse Y-offset with proper border accounting
Fixed SSH server not initializing keybinding registry
Fixed help menu search escape key switching modes incorrectly

Documentation

Added comprehensive documentation suite with 4 new guides
Restructured README for clearer quick start experience
Added shell completion setup instructions
Included CLI migration guide for upgrading users

Other Changes

Refactored copy mode into modular components
Enhanced character search functionality
Updated nix package to v0.0.23

Full Changelog: v0.0.22...v0.0.23

Closes: #15
Partially Addresses: #13