omniterm

OmniTerm

Your agent terminals, accessible everywhere.

Why OmniTerm?

• Built for AI agents — run Claude Code, Codex, or any CLI agent in a terminal
• Always running — 24/7, persist across browser closes, network drops, and device switches
• Work from anywhere — start on your desktop / cloud, continue from your iPad, smartphone
• Easy setup — one command to start, accessible through the browser. No SSH tunnels
• Lightweight — under 1MB package, loads in under 2 seconds

Quick Start

Install dependencies first:

# macOS
brew install tmux ttyd

# Ubuntu/Debian
sudo apt install tmux
sudo snap install ttyd --classic

Then install and run:

npm install -g omniterm
omniterm
# Open http://localhost:17717

Custom port:

omniterm --port 8080

OmniTerm uses ports 7700-7799 internally for terminal sessions. If this range conflicts, override it:

omniterm --ttyd-ports 8800-8899

Run omniterm --help for all options.

What You Get

Terminals

• Multiple tabs, each containing one or more terminal panes
• Split terminals side-by-side or top/bottom within a tab
• Drag to reorder tabs, double-click to rename
• Sessions survive browser disconnects and server restarts
• Mouse wheel scrollback, native text selection

Workspaces

• Switch between git repos, worktrees, and directories
• Clone repos or browse the server filesystem to add new workspaces
• Create and manage git worktrees with one click
• Discovers existing tmux sessions automatically — start a session from SSH, see it in the browser

File Explorer & Editor

• Browse files, edit with syntax highlighting and Cmd+S save
• Supports TypeScript, Python, JSON, Markdown, CSS, HTML
• Auto-refreshes file tree and editor content on window focus
• Unsaved changes protection when switching files

Mobile & Desktop

• Full terminal experience on phones and tablets
• Add to home screen for a native app feel (PWA)
• Desktop: overlay panels for workspaces and files
• Mobile: full-screen views with touch navigation

Use Cases

AI Agent Fleet

Run multiple AI agents in parallel, each in its own workspace. Split terminals to monitor two agents side by side. Review their output in the editor.

Remote Development

Code on a powerful cloud server from any device. Start a build on your desktop, check results from your iPad. The terminal never stops.

Pair Programming with AI

One pane for your agent, another for your build server, the editor on the side. The agent writes code, you review and edit — all in one browser tab.

Remote Access

Access via SSH tunnel or VPN:

ssh -L 17717:localhost:17717 your-server
open http://localhost:17717

Or directly via Tailscale:

open http://your-server.tailnet:17717

Development

pnpm install
pnpm run dev
# Open http://localhost:17717

License

MIT