TUIOS Terminal Workspace

Manage panes, sessions, and coding agents in a recoverable terminal workspace.

Stars
★ 6.6k
Last updated
today
License
MIT
Primary language
Go

At a glance

How it runs
CLISelf-hosted serviceMCP server
Works with
Universal · cross-platformCodex · Claude Code (Partial support)
Cost
Free, no paid service needed
Setup effort
Medium · a few setup steps
You'll need
Go 1.26.6 or newerSSHA terminal with true color supportShell / CLINetwork accessLocal filesystemMCP Server
Typical use
Developers running builds, tests, and shells side by side can tile panes and separate tasks into workspaces.
Not a fit if
  • Users who work only in graphical interfaces and do not need terminal workflows
  • Users who need full image and animation support in a basic terminal
Website
tuios.dev ↗ set on GitHub
Maintenance
Commits in the last 30 dayslast commit 2026-11-21latest release v0.13.3 (2026-11-16)+11.4 ★/day over 7 days
Source review
74/100 · Some gaps

What does this agent do, and when should you use it?

TUIOS is a Go terminal multiplexer and window manager that runs inside an existing terminal, with Vim-style modal controls, multiple panes, workspaces, and BSP tiling. A daemon keeps sessions alive and supports detaching, reattaching, and restoring session layouts after daemon or machine restarts. Coding agents can report their state through integrations, while an Inbox collects approvals, questions, errors, and completion notices across sessions and machines. Other programs can report status through OSC 7501 or tuios status, and agents can message or question one another through tuios commands. The project also documents SSH remote sessions, a separate web-terminal binary, and an MCP server mode; graphics features depend on terminal support.

TUIOS starts shells or other commands in terminal panes that users can create, resize, drag, and tile, then organize with workspaces, layout modes, and session commands. Its daemon preserves session structure and working directories and supports detach/reattach and access across machines. tuios integration install wires 19 harnesses for state reporting, and TUIOS also detects 24 agent CLIs by process and screen; state appears in pane titles and the sidebar. Other programs can report state with tuios status or OSC 7501. The Inbox gathers approvals, questions, mail, errors, and completed turns, and users can respond to prompts there. tuios fan starts several agents in separate Git worktrees, tuios send-agent-message and tuios ask-agent support agent communication, and tuios mcp exposes a read-only MCP interface limited to the agent's own session by default.

  1. Developers running builds, tests, and shells side by side can tile panes and separate tasks into workspaces.
  2. Individual developers who often close terminals or reboot can use daemon sessions to retain pane structure and working directories.
  3. Developers running Claude Code, Codex, Gemini CLI, or opencode can surface agent state and pending approvals in the Inbox.
  4. Engineers working across machines can add SSH hosts, attach remote sessions, or run panes on remote hosts.
  5. Maintainers who repeat terminal workflows can record, replay, or execute workflows against a running session with tape scripts.

Key setup facts

Pulled from the install and usage notes below. The project README has the current values.

Install / run
  • brew install tuios
  • go install github.com/Gaurav-Gosain/tuios/cmd/tuios@latest
Runtime
Go 1.26.6
Install notes cover
macOS · Docker

How do you install or deploy this agent?

Install with Homebrew; other documented options include Arch AUR, Nix, go install, Docker, and release binaries. Building from source requires Go 1.26.6 or newer. The runtime requirement is a terminal with true color support; Kitty graphics and Sixel are recommended. SSH is needed for SSH host features. The README does not state a price; its listed install and run methods do not require model API keys.

brew install tuios

Go installation:

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

Build from source:

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

How do you use this agent?

Run tuios to launch; by default it attaches to a daemon-backed session. Create and reattach to a persistent session, or list sessions with tuios ls. The default prefix key is Ctrl+B, and keybindings can be configured.

tuios

Persistent session example:

tuios new mysession
tuios attach mysession
tuios ls

After installing agent-state integrations, use the Inbox to review pending items; tuios mcp starts the MCP server. Configure remote hosts with tuios hosts add, then connect to a remote session with tuios attach --host. Exact setup options vary by target agent and host policy; the README does not give one universal credential checklist.

What are this agent's strengths and limitations?

Pros
  • Daemon sessions support detach and reattach, and can restore session structure and working directories after restarts.
  • The Inbox consolidates agent approvals, questions, messages, errors, and completion states across sessions and machines.
  • It can start multiple agents in separate Git worktrees and includes commands for agent-to-agent questions and messages.
  • Event-driven rendering is described as using zero CPU while idle.
Limitations
  • Users need to learn Vim-style modal controls and a configurable prefix key, which defaults to Ctrl+B.
  • Kitty graphics and Sixel depend on terminal support; Sixel is experimental and lacks pixel-level clipping.
  • Multi-machine sessions require SSH host and policy configuration.
  • Building from source requires Go 1.26.6 or newer.

How does this agent compare with similar options?

The README presents TUIOS as a tmux alternative and cites tmux, vim, and i3 as design influences. Beyond terminal-pane management, TUIOS adds agent state, a cross-session Inbox, agent messaging, and cross-machine sessions; whether it fits as a replacement depends on whether you need those integrations and their configuration.

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
TUIOS Terminal Workspace This agent 74 · Some gaps CLIFree ★ 6.6k today Go —
tty7 Terminal Workbench 84 · Good Desktop appFree ★ 1.5k 1d ago Rust —
herdr-core (hc) 58 · Major gaps CLIFree ★ 847 5d ago Rust —
cmux 79 · Good Desktop appFreemium ★ 29k today Swift Codex · Claude Code

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Some gaps
74/ 100 5-point scale 3.7 / 5
This review covers the source as of Nov 07, 2026. The project has shipped 3 stable release(s) since, which have not been re-reviewed. The score and verdict describe the reviewed version only. Recent releases ↓
Trust 19/29
Reliability 9/14
Adaptability 15/18
Convention 14/18
Effectiveness 12/13
Verifiability 5/8
Why each dimension lost points
Trust19 / 29 · 3.3/5

The skill explicitly forbids typing into needs_input panes, closing panes it did not open, and acting on external requests without human verification. The web server also exposes read-only mode, connection limits, TLS, and authentication options. Configuration documentation says some edits write files and require confirmation. Deductions: the product has broad abilities including command execution, cross-host sessions, plugins, hooks, and browser terminals, while the packet does not establish permission defaults and data boundaries for each; web code notes that without a password on localhost, other users on the machine can connect.

Reliability9 / 14 · 3.2/5

The packet describes command-to-skill checks, CI selection logic, static checks, and test procedures, and gives concrete failure handling such as run refusing to type when shell integration is absent. Deductions: these are primarily documentation and workflow descriptions, not observed CI results; the README's Go version statement does not fully align with go.mod's go/toolchain versions, weakening consistency.

Adaptability15 / 18 · 4.2/5

The README addresses terminal users, agents, remote hosts, terminal graphics protocols, and several installation environments. AGENTS.md distinguishes contributor guidance from the pane-agent skill. Deductions: the CLI skill targets agents already inside a tuios pane, while trigger conditions, capability limits, and compatibility boundaries for other Agent frameworks are not systematically established in this sample.

Convention14 / 18 · 3.9/5

Documentation is organized around installation, quick start, sessions, configuration, agents, protocols, and architecture, with multiple install commands, key examples, and an MIT license. The security policy identifies supported versions and a vulnerability reporting path. Deductions: the packet shows only one example release note, not a complete change history; the policy says there is no stable release while release material identifies a version, leaving status somewhat inconsistent; maintenance is assigned to personal free time with no guaranteed response time.

Effectiveness12 / 13 · 4.6/5

The product adds session persistence, agent state, and a shared Inbox to multi-pane terminal work, with copyable commands, key tables, and structured surfaces. Deductions: setup and operation of multi-host agents, plugins, and the web terminal add complexity, and the packet provides no measured benefit or cost comparison against ordinary terminal multiplexers.

Verifiability5 / 8 · 3.1/5

README features link to focused documentation; AGENTS.md connects the skill source, embedding, and command-tree checks; configuration documentation describes an option registry; CI files enumerate concrete checks. Deductions: many performance and coverage claims in the README have no corresponding measurements in this packet, workflow definitions are not execution evidence, and the code excerpts are incomplete, so corroboration is partial.

Risks and how to mitigate them
  • The browser terminal can expose a shell. Understand TLS and authentication options before binding beyond loopback; unauthenticated localhost access is available to other users on the same machine.
  • Agent tools can run commands, operate across hosts, and modify configuration. Check the target pane, host policy, grants, and file-writing effects before use.
  • The static packet does not establish that CI or tests passed for this revision, and it samples rather than includes all source and skill files.
Evidence confidence: Low Reviewed Nov 07, 2026 Reviewed revision 1eb246ab2acd New commits since this review; the score may not cover them
See the full review method →
Maintain this project? Add the FARS badge to your README

The badge shows the current review score and verdict and links back to this page. It refreshes about once an hour after a re-review.

FARS

[![FARS review](https://followagents.com/badge/tuios.svg)](https://followagents.com/en/agents/tuios)
<a href="https://followagents.com/en/agents/tuios"><img src="https://followagents.com/badge/tuios.svg" alt="FARS review"></a>

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. v0.13.3
    Release notes excerpt
    tuios 0.13.3 is a security and fix release. It closes four issues that @cr2007 reported privately, and I recommend it to everyone. It also fixes a regression from v0.13.2 in the focus keys, and a few bugs you reported. Upgrading from v0.13.1 or later is live on macOS and Linux: install, then run tuios daemon upgrade, and every program in your panes keeps running. ```bash brew install tuios # Homebrew (macOS, Linux) yay -S tuios-bin # AUR (tuios-web-bin for the web server) nix run github:Gaurav-Gosain/tuios # Nix …
    View on GitHub ↗
  2. v0.13.2
    Release notes excerpt
    tuios 0.13.2 is a small release, and nearly all of it is the agents view (ctrl+b i). This round fixes the rough edges that show up when you run a lot of agents at once. Code blocks in the thread wrap, scroll sideways and copy with one key. File paths open in quick look on a click. An answer moves you to the next agent that needs you, and r no longer rejects anything. Upgrading from v0.13.1 is live on macOS and Linux: install, then run tuios daemon upgrade, and every program in your panes keeps running. ```bash brew install tuios # Homebrew (macOS, Linux) …
    View on GitHub ↗
  3. v0.13.1
    Release notes excerpt
    ![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](https://github.com/user-attachments/assets/7ecac6d3-6d4c-4078-a03b-3099df929e2e) 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 …
    View on GitHub ↗

FAQ

Does TUIOS require a paid model or API key?
The README describes a terminal multiplexer and agent integrations but does not list model API keys or paid plans.
Do sessions survive closing a terminal or restarting?
The daemon keeps sessions running after their terminal window closes. The docs also describe restoring session structure and working directories after daemon or machine restarts.
Which coding agents can report state?
tuios integration install configures 19 harnesses, and TUIOS also detects 24 agent CLIs by process and screen. See the agent guide for specific names and integration methods.
Can I use it without a terminal that supports graphics protocols?
The core terminal workspace can run, but graphics features such as Kitty graphics and Sixel depend on terminal support; the README recommends terminals that support them.
Can I operate sessions from another machine?
Yes. Configure SSH hosts to attach to remote sessions, run panes on a remote host, or run agents there.
Is TUIOS Terminal Workspace open source?
Yes. The source code is on GitHub (Gaurav-Gosain/tuios) under the MIT licence.
Is TUIOS Terminal Workspace safe to use?
FollowAgents' FARS review (Nov 07, 2026) scored TUIOS Terminal Workspace 19/29 on trust and safety. None of the eight safety controls the review checks for was missing outright. The repository has changed since that review.
Is TUIOS Terminal Workspace still maintained?
Yes. The latest commit on GitHub is from 2026-11-21, within the last 30 days. The latest release is v0.13.3 (2026-11-16).
Who makes TUIOS Terminal Workspace?
TUIOS Terminal Workspace is published on GitHub by the account Gaurav-Gosain. FollowAgents has not verified which person or company is behind that account.
What is TUIOS Terminal Workspace's official website?
The project's GitHub repository lists https://tuios.dev as its website. That link is set by the repository owner; the source code itself is on GitHub (Gaurav-Gosain/tuios).
Was this page helpful?
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related concepts