omniterm 0.2.5

Web-based tmux terminal manager — one browser tab to watch and drive your AI coding agents
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

# OmniTerm

> *One browser tab to watch — and drive — every AI coding agent.*

[![License](https://img.shields.io/badge/License-FSL--1.1--MIT-blue.svg)](LICENSE)

**Claude Code · Codex · Gemini · OpenCode · Qwen Code · Kiro** …

![screenshot](pic/overview.png)

> [中文](README_ZH.md)

## Sound familiar?

You've got several AI coding agents running at once — Claude Code in one terminal, Codex in another, Gemini in a third. You keep switching between them, checking one by one: which one finished? which one's stuck waiting for you to confirm? which one errored out ages ago?

**OmniTerm pulls them all into a single browser tab.** Each agent gets a card that tells you what it's doing in real time; when it needs you, the tab flashes, a sound plays, and you know instantly. Most of the time, you just watch them work.

## What you can do with it

**See every agent at a glance** — running, waiting for input, or done. Live status for each, no more flipping through windows one by one.

**Drive agents like a chat** — pick an agent and just talk (over the [ACP protocol](https://agentclientprotocol.com/)): its replies become clean text, tool-call cards, and collapsible thinking — not a wall of terminal text. One-click presets for Claude Code, Codex, Gemini, OpenCode, Qwen Code, and Kiro.

**Step in exactly when it matters** — approve or deny a tool right where it asks; switch models or thinking level mid-session.

**Get pinged the moment you're needed** — permission requests and waiting prompts trigger a tab flash + sound + sidebar badge, even if you've navigated away.

**Jump in anytime** — built-in terminal (xterm.js) and file browser for when you want to read code, edit files, or run commands — mobile soft keyboard included.

**Easy on memory** — release a session with one click to free memory while keeping the log; resume anytime. Idle sessions recycle themselves.

**Knows your project** — auto-detects git worktrees and groups sessions by branch, file browser follows the current directory, syntax highlighting for 13 languages.

## Quick start

```bash
cargo install omniterm        # or see other methods below
omniterm                      # open http://localhost:9077
```

In the browser, set an initial password, add a project directory, and start a session — pick an agent for chat mode, or leave it blank for a plain terminal. Upgrade anytime with `omniterm update`.

<details>
<summary>Other install methods (npm / Shell script / PowerShell / Docker)</summary>

**Prerequisites**: tmux (on Windows, use [psmux](https://github.com/psmux/psmux) instead).

```bash
# npm (requires Node.js >= 18, cross-platform)
npm install -g @gdwhisper/omniterm
```

```bash
# Shell script (Linux/macOS) — installs tmux automatically if missing
curl -fsSL https://raw.githubusercontent.com/GDWhisper/OmniTerm/main/install.sh | bash
```

```powershell
# PowerShell (Windows) — bring your own psmux or tmux
irm https://raw.githubusercontent.com/GDWhisper/OmniTerm/main/install.ps1 | iex
```

```bash
# Docker — tmux bundled
docker run -d -p 9077:9077 -v omniterm-data:/app/data ghcr.io/GDWhisper/omniterm
```

</details>

---

## For developers

Single-binary deployment: Rust backend with embedded frontend and SQLite, one command to start.

| Layer | Technology |
|-------|-----------|
| Backend | Rust + Axum + SQLite |
| Frontend | React 19 + Tailwind CSS 4 + xterm.js |
| Agent protocol | [ACP](https://agentclientprotocol.com/) client + tmux control mode |
| Terminal bridge | portable-pty + WebSocket |

**Contributing** — ⭐ Star the repo; 🐛 [Issues](https://github.com/GDWhisper/OmniTerm/issues) for bugs or ideas.

**License** — FSL-1.1-MIT © [GDWhisper](https://github.com/GDWhisper)