Gaurav-Gosain /tuios
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. Official only at tuios.dev and this repo. tuios has no X/Twitter account.
★ 6,534⑂ 322👁 16⑃ 1,728● 358▤ 56
+6
日增长
+72
周增长
+1,302
月增长
6,534
stars
322
forks
16
watchers
1,728
prs
358
issues
56
releases
README
TUIOS: Terminal UI Operating System 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. Already installed it? Run tuios tutor for the same tour in your own terminal. It changes nothing on your machine. What changed in v0.10.1 is in the release notes. Quick Links - Getting Started: Install and first session - Keybindings: Default keys and how to rebind them - BSP Tiling: Tiling with preselection and split control - Layout Modes: BSP, master-stack and scrolling layouts, every window, multifocus - Configuration: Customize keybindings, themes, and behavior - Hooks: Run shell commands on window, session and agent events - Themes: Built-in themes and custom theme JSON - Glyph sets: The characters the chrome is drawn with - CLI Reference: All command-line options - Tape Scripting: Automate workflows - Sessions: Daemon mode, attach/detach, other machines, and what survives - Agents: Running coding agents in tuios: state, the Inbox, approvals, fleets, other machines, grants and MCP - Program Status: OSC 7501 from any program, tuios status, and the reports tuios sends to its own terminal - tmux Shim: Run tools that drive tmux, such as Claude Code agent teams - Control Protocol: JSON verb protocol for driving the daemon - Architecture: Technical design Table of Contents - Installation - Features - Quick Start - Architecture - Performance - Development - Contributors - License Installation Package Managers Homebrew (macOS/Linux): bash 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. bash brew uninstall tuios brew install gaurav-gosain/tap/tuios-ghostty Arch Linux (AUR): bash yay -S tuios-bin Nix: bash nix run github:Gaurav-Gosain/tuios/v0.10.1tuios a release nix run github:Gaurav-Gosain/tuiostuios the latest main nix run nixpkgstuios 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 bash Quick install script (Linux
Top issues
#1673[FEATURE]: tuios needs a contextual help mode6 comments · 2026-11-06#1444[FEATURE]: Jujutsu (jj) support in the rail, review, worktrees and ship5 comments · 2026-11-01#655[FEATURE]: A privacy mode that masks sensitive text in panes while you share your screen3 comments · 2026-10-12#2090[FEATURE]: {title} placeholder in dock_workspace_tab_format (workspace tab follows its focused pane, like tmux automatic-rename)2 comments · 2026-11-14#151Keyboard focus adds empty lines to a pane on macOS, and no keyboard path resizes on Linux2 comments · 2026-09-05#2132In the agents view, w under 170 columns changes nothing on screen but hides the side column later1 comments · 2026-11-15#2004[FEATURE]: Option for resize_pane_* to move the divider in the key's direction, like tmux1 comments · 2026-11-12#1872[FEATURE]: keep the done mark for a configurable time after the pane is seen (done_hold)1 comments · 2026-11-11
Discussions
#2124Cycle 5 scope: how do you want state machines, config, comments and test removals shaped?1 comments · 2026-11-15#2080Agents take a different route each time they start an agent in a worktree2 comments · 2026-11-13#2076Should ask-agent remove invisible characters from the text it types?1 comments · 2026-11-13#1947libghostty backend4 comments · 2026-11-11#1862scroll back issue in pi ai agent1 comments · 2026-11-10#1645A size map of non-core features, and four small offers1 comments · 2026-11-06#1207Thank you for TUIOS — from a user with ADHD5 comments · 2026-10-27#1182Customizing Dock Mode Indicator Priority3 comments · 2026-10-26
Latest release
v0.13.1 v0.13.1 2026-11-15!The tuios mascot Tilly beside the words tuios 0.13, From 0.12.1: one restart. Live upgrades from 0.13.0 on. tuios.dev tuios 0.13.1 is a big one, so I skipped 0.12.2 and gave it a new minor number. It is the first 0.13 release: the v0.13.0 tag exists, but its release build failed, so nothing was published from it. Agents get a task board that runs itself, from a card to a pull request, and an agent can hand work to a child agent and get the answer back by mail. You can now move the daemon to a new build without ending a single pane, and the client on your machine follows it. Linking another m
相关报道 (3)
News & coverage (3)
Hacker News(⌐■_■) TUIOS is an experimental terminal tiling multiplexer▲ 5 · 0 comments · 2025-10-20xGaurav Gosain on X: "tuios just hit 4,000 stars on github! Huge milestone for me and definitely a motivator to keep going, thanks to everyone who is part of the journey!!"2026-09-27It's FOSSLooking Beyond Tmux and Screen: 8 Terminal Multiplexers Worth Trying2026-08-17