explaingit

antonlobanovskiy/agent-tmux-web

Analysis updated 2026-05-18

13TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A web app that lets you control long running AI coding agents in tmux from your phone or browser without keeping an SSH session open.

Mindmap

mindmap
  root((AgentTmuxWeb))
    What it does
      Control tmux agents
      Browser interface
      No SSH needed
    Tech stack
      TypeScript
    Use cases
      Mobile supervision
      Read transcripts
      Get notifications
    Audience
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check on a remote AI coding agent from your phone while commuting

USE CASE 2

Read a chat style transcript of an agent's tmux session

USE CASE 3

Attach to the raw terminal for precise keyboard control when needed

USE CASE 4

Get notified on your phone when an agent finishes a task

What is it built with?

TypeScript

How does it compare?

antonlobanovskiy/agent-tmux-webandersondanieln/hexllamabb8ad8/addroid-oss
Stars131313
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasyhard
Complexity3/52/54/5
Audiencedevelopervibe coderpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a remote server running tmux with your AI agent sessions already set up.

In plain English

Agent Tmux Web is a TypeScript web application that lets you control long-running terminal AI agents, such as Codex, Claude, and Gemini, from your phone or desktop browser, without needing to keep an SSH session open. Tmux is a program that keeps command-line sessions running on a server even after you disconnect, this project wraps those sessions in a browser-friendly interface so you can check in on your agents, read their output, and send new input from anywhere. The problem it solves is that using AI agents on mobile is awkward: SSH sessions break on disconnect, resizing a terminal on a small screen is painful, and managing multiple agents at once is tedious. Agent Tmux Web keeps the actual work happening on your server inside tmux, while giving your browser a cleaner control panel on top. You get two views: a readable chat-style transcript of the agent's output, and a raw terminal attach mode for when you need precise keyboard control. Beyond just viewing output, you can launch agents from a menu, switch between multiple tmux sessions, upload files from Android, iOS, or desktop to share with an agent, and receive browser or Android notifications when an agent finishes a task and is waiting for your next input. The project also includes a native Android wrapper app that stores your server address and handles notifications in the background. You would use this when you run AI coding agents on a remote server and want to supervise or interact with them from your phone, for example, while commuting or away from your desk. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Help me set up Agent Tmux Web to control a Codex session running in tmux on my server
Prompt 2
Show me how to switch between multiple tmux sessions in the browser interface
Prompt 3
Explain how to upload a file from my phone to share with a running agent
Prompt 4
Write a config to enable notifications when an agent is waiting for input

Frequently asked questions

What is agent-tmux-web?

A web app that lets you control long running AI coding agents in tmux from your phone or browser without keeping an SSH session open.

What language is agent-tmux-web written in?

Mainly TypeScript. The stack also includes TypeScript.

How hard is agent-tmux-web to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is agent-tmux-web for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.