The terminal multiplexer has been a cornerstone of developer productivity for over three decades. Utilities like screen and tmux established a reliable paradigm: decouple terminal sessions from graphical emulator windows, divide the screen into tiling panes, and maintain background persistence over network disconnects.
However, the nature of terminal workloads has fundamentally shifted. Today’s software engineers are rarely running just a shell, an editor, and a log tail. Instead, terminals are rapidly becoming runtime environments for autonomous AI coding agents—including Claude Code, Codex CLI, OpenCode, Gemini CLI, and specialized multi-agent harnesses.
Running multiple agents simultaneously exposes severe limitations in legacy multiplexers:
- Zero Process Awareness: Multiplexers treat all pane contents as blind byte streams. A crashed compiler, an active build, and an agent stuck waiting for human permission look identical to the window manager.
- Context Fragmentation: Monitoring three agents across separate tabs or windows requires constant context switching and manual polling.
- Lack of Modern Protocol Support: High-resolution image protocols (Kitty graphics), synchronized updates, and animation frames are often poorly supported or cause severe screen tearing.
TUIOS (Gaurav-Gosain/tuios), created by Gaurav Gosain, addresses these challenges directly. Written in Go on top of the modern Charm ecosystem (Bubble Tea v2 and Lipgloss v2), TUIOS is an agent-aware terminal operating system and window manager built specifically for modern multi-agent development workflows.
The Core Architecture: An Agent-Aware Multiplexer
Unlike traditional multiplexers that operate solely as pseudo-terminal (PTY) routers, TUIOS embeds an observability layer directly into its session daemon.
┌─────────────────────────────────────────────────────────────┐
│ TUIOS Daemon │
│ │
│ ┌───────────────────────────┐ ┌─────────────────────────┐ │
│ │ Session & Layout Engine │ │ Agent Observability │ │
│ │ (BSP Tiling / Workspaces│ │ (Process & Hook Stream)│ │
│ └─────────────┬─────────────┘ └────────────┬────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌───────────────────────────┐ ┌─────────────────────────┐ │
│ │ Charm TUI Interface │ │ Central Agent Inbox │ │
│ │ (Bubble Tea / Lipgloss) │ │ (1-Key Approval / Mail)│ │
│ └───────────────────────────┘ └─────────────────────────┘ │
└──────────────────────────────┬──────────────────────────────┘
│
┌─────────────────────┼─────────────────────┐
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ Claude │ │ Codex │ │ OpenCode │
│ Agent (1) │ │ Agent (2) │ │ Agent (3) │
└───────────┘ └───────────┘ └───────────┘
The daemon monitors running processes and integrates with agent lifecycle hooks across 19 major coding harnesses, auto-detecting more than 24 agent CLIs automatically.
Key Capabilities
1. The Unified Agent Inbox (Prefix + i)
The headline feature of TUIOS is its Inbox. Instead of cycling through panes to check whether an agent has finished or requires permissions:
- Pressing
Prefix + i opens a global inbox overlay displaying every pending decision, question, warning, and completed task.
- Developers can review diffs and answer permission requests (such as filesystem writes or shell command executions for Claude Code, OpenCode, Kilo, and Qwen Code) directly from the inbox with a single keystroke.
- Pressing
Prefix + o immediately jumps to the oldest pending item across all workspaces and connected machines.
2. Agent Fleets (tuios fan)
TUIOS allows developers to fan out tasks across parallel agents with a single command:
# Fan out a prompt to multiple agents across isolated git worktrees
tuios fan "Implement authentication middleware with unit tests"
Each spawned agent executes inside an isolated git worktree, preventing concurrent workspace collisions while reporting its real-time progress back to the master TUIOS sidebar.
3. Transparent tmux Compatibility Shim
Migrating workflows away from decades of muscle memory and tooling is notoriously difficult. TUIOS solves this by shipping a built-in tmux-shim:
tuios tmux-shim
Any script, tool, or agent harness designed to automate tmux (such as Claude Code agent teams or orchestration scripts) will continue working unmodified, with panes created natively inside TUIOS.
TUIOS features native support for the Kitty graphics and animation protocol:
- True In-Terminal Graphics: Renders high-resolution images and diagrams directly in the terminal grid.
- Flicker-Free Video: Enables smooth video playback inside panes via
mpv --vo=kitty.
- Damage-Patch Streaming: Supports progressive animation frames (
a=f), transmitting only modified rectangular regions rather than re-rendering the entire bitmap on every tick.
5. Remote and Multi-Machine Sessions over Tailscale
TUIOS seamlessly bridges multiple development machines. Using the hosts command or native Tailscale discovery, you can attach to remote development hosts, run panes on cloud instances, and manage all remote agent tasks within a unified local UI:
# Attach to a remote host session over SSH or Tailscale
tuios attach --host build-server dev-session
Installation & Quick Start
TUIOS provides pre-compiled binaries for Linux, macOS, Windows, FreeBSD, and OpenBSD.
Using Homebrew (macOS / Linux)
brew install tuios
Using Arch Linux (AUR)
yay -S tuios-bin
Using Go
go install github.com/Gaurav-Gosain/tuios/cmd/tuios@latest
Launching TUIOS
Start a session by simply running:
tuios
Once inside:
Ctrl + P: Open the fuzzy command palette.Alt + Space: Launch applications and binaries on your $PATH.Prefix + i: Access the centralized Agent Inbox.Prefix + z: Zoom into the active pane.Prefix + ,: Open the in-app interactive configuration menu.
Conclusion
As software engineering workflows increasingly blend manual authoring with concurrent AI agent orchestration, the terminal multiplexer must do more than just split windows.
By unifying process observability, agent approvals, fleet isolation, and high-performance terminal rendering, TUIOS establishes a new baseline for developer workspaces in the agentic era.