TUIOS Terminal Workspace
Manage panes, sessions, and coding agents in a recoverable terminal workspace.
- Source repo
- Gaurav-Gosain/tuios
- Stars
- ★ 6.6k
- Last updated
- today
- License
- MIT
- Primary language
- Go
- FA score
- 74/100 · Some gaps
At a glance
- How it runs
- 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
- 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.
- Developers running builds, tests, and shells side by side can tile panes and separate tasks into workspaces.
- Individual developers who often close terminals or reboot can use daemon sessions to retain pane structure and working directories.
- Developers running Claude Code, Codex, Gemini CLI, or opencode can surface agent state and pending approvals in the Inbox.
- Engineers working across machines can add SSH hosts, attach remote sessions, or run panes on remote hosts.
- 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 tuiosgo 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 tuiosGo installation:
go install github.com/Gaurav-Gosain/tuios/cmd/tuios@latestBuild from source:
git clone https://github.com/gaurav-gosain/tuios.git
cd tuios
go build -o tuios ./cmd/tuios
./tuiosHow 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.
tuiosPersistent session example:
tuios new mysession
tuios attach mysession
tuios lsAfter 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?
- 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.
- 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?
Why each dimension lost points
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.
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.
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.
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.
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.
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.
- 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.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
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 ↗ -
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 ↗ -
Release notes excerpt
 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?
Do sessions survive closing a terminal or restarting?
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?
Can I operate sessions from another machine?
Is TUIOS Terminal Workspace open source?
Is TUIOS Terminal Workspace safe to use?
Is TUIOS Terminal Workspace still maintained?
Who makes TUIOS Terminal Workspace?
What is TUIOS Terminal Workspace's official website?
Thanks — we use this to improve the page.