# AI use cases for Tuios (Gaurav-Gosain/tuios)

Repo: [Gaurav-Gosain/tuios](https://github.com/Gaurav-Gosain/tuios) | Use cases: 3 | Page: https://dedupedai.com/use-cases/gaurav-gosain-tuios/

TUIOS is a terminal multiplexer and window manager built with Go, with tiled panes, workspaces, BSP tiling and a command palette, all 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.

This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL.

- See which coding agents need you, in one terminal: https://dedupedai.com/use-cases/gaurav-gosain-tuios/see-every-coding-agent-state-in-one-terminal/
- Send one prompt to several agents, each in its own worktree: https://dedupedai.com/use-cases/gaurav-gosain-tuios/fan-one-prompt-out-to-several-agents/
- Run Claude Code agent teams in Tuios panes: https://dedupedai.com/use-cases/gaurav-gosain-tuios/run-claude-code-agent-teams-in-tuios-panes/

## How to see which coding agents need you, in one terminal with Tuios

Repo: [Gaurav-Gosain/tuios](https://github.com/Gaurav-Gosain/tuios) | Difficulty: Beginner | Time: 20 minutes | Basis: From the README

Install Tuios, wire up your agent harnesses and use the Inbox for approvals and questions.

**Who it is for:** A developer running Claude Code and Codex in several panes who keeps missing which one is waiting.

**The problem:** Agents stall on a permission prompt in a background tab and nobody notices for an hour.

**The outcome:** Panes that show whether each agent is working, waiting for you, done or errored, and one Inbox for everything waiting.

### Steps

1. Install with `brew install tuios` on macOS or Linux, or `go install github.com/Gaurav-Gosain/tuios/cmd/tuios@latest`
2. Run `tuios integration install` to wire the supported harnesses (Claude Code, Codex, Gemini CLI, opencode and more) to report state
3. Start an agent in a pane and watch its state in the pane title and on the rail
4. Press Prefix + i to open the Inbox with approvals, questions, mail, errors and finished turns, and Prefix + o to jump to the oldest

### Prompt to paste into your agent

```text
Install tuios from Gaurav-Gosain/tuios with `brew install tuios`, then run `tuios integration install` and tell me which harnesses it wired up. Show me how to open the Inbox with Prefix + i and what the pane state shapes mean.
```

### Caveat

The README warns that an X account called @tuiosdev is an impostor; Tuios has no X account, token or presale and lives only at Tuios.dev and its repo.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/gaurav-gosain-tuios/see-every-coding-agent-state-in-one-terminal/

## How to send one prompt to several agents, each in its own worktree with Tuios

Repo: [Gaurav-Gosain/tuios](https://github.com/Gaurav-Gosain/tuios) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Use Tuios fan to start the same prompt in a mix of agents, then follow them in the Inbox.

**Who it is for:** A developer who wants to compare how different agents solve the same task without them overwriting each other.

**The problem:** Running agents side by side usually means manual terminals and branches that collide.

**The outcome:** Several agents working one prompt in separate git worktrees, addressable together as a group.

### Steps

1. Install Tuios and run `tuios integration install` so the agents report their state
2. Run `tuios fan` with your prompt to start it in several agents, mixed harnesses allowed, each in its own git worktree
3. Use `tuios start-agent` when you want one helper beside you, in its TUI or headless over ACP or the Codex app-server
4. Address a whole group with selectors such as `group:fan/retry needs:you`
5. Read each agent's changes in Review and send notes back

### Prompt to paste into your agent

```text
With tuios from Gaurav-Gosain/tuios, use `tuios fan` to run this prompt in two different agents, each in its own git worktree: <prompt>. Tell me where each worktree is and when each agent finishes, and do not merge anything.
```

### Caveat

Fleets write into git worktrees of your repo, so start from a clean branch and review each result before merging.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/gaurav-gosain-tuios/fan-one-prompt-out-to-several-agents/

## How to run Claude Code agent teams in Tuios panes with Tuios

Repo: [Gaurav-Gosain/tuios](https://github.com/Gaurav-Gosain/tuios) | Difficulty: Advanced | Time: 30 minutes | Basis: From the README

Use the tmux shim so tools that drive tmux open their panes as Tuios panes.

**Who it is for:** A Claude Code user running agent teams who wants their panes managed by Tuios rather than tmux.

**The problem:** Some agent tools assume tmux, which leaves you without Tuios' agent state and Inbox.

**The outcome:** Agent team panes opened as Tuios panes, with their state on the rail.

### Steps

1. Install Tuios and make sure the daemon is running for your session
2. Run `tuios tmux-shim` so tools that drive tmux, such as Claude Code agent teams, work through Tuios
3. Start your agent team and watch each pane appear in Tuios
4. Run `tuios --skill` to print the short guide an agent in a pane reads to drive Tuios

### Prompt to paste into your agent

```text
In tuios from Gaurav-Gosain/tuios, set up `tuios tmux-shim` for Claude Code agent teams, then run `tuios --skill` and summarize what it teaches an agent. Tell me exactly what to change in my setup before you change it.
```

### Caveat

The README points to docs/TMUX_SHIM.md for details, so read it before relying on the shim in daily work.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/gaurav-gosain-tuios/run-claude-code-agent-teams-in-tuios-panes/