gitwtfhub

wtf is nexus?

zzszmyf/nexus — explained in plain English

Analysis updated 2026-05-18

14GoAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A browser-based gateway that lets you control AI coding agents like Claude Code or Codex running in tmux sessions from a desktop terminal or phone chat UI.

Mindmap

mindmap
  root((Nexus))
    What it does
      Browser controls agents
      Routes via gateway
      tmux runs agents
    Tech stack
      Go
      tmux
      WebSocket
      xterm.js
    Use cases
      Remote agent access
      Desktop terminal view
      Mobile chat view
    Architecture
      Browser UI
      Gateway routing
      tmux client worker
    Audience
      Developers using AI agents

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

Why would anyone build with this?

REASON 1

Control an AI coding agent running on a remote machine from your phone's browser.

REASON 2

Get a full desktop terminal view of a tmux session running Claude Code or Codex.

REASON 3

Self-host a gateway on a small cloud server while your code stays on your own machine.

What's in the stack?

GotmuxWebSocketxterm.js

How it stacks up

zzszmyf/nexusgizmodata/adbc-driver-quackgokele/ovh
Stars141414
LanguageGoGoGo
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencedeveloperdeveloperops devops

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Go 1.24 or newer and tmux installed on any machine running agents.

Free to use, modify, and distribute, including commercially, as long as you include the license and note any changes made.

Wtf does this do

nexus is a tool that lets someone control AI coding agents, such as Claude Code, Codex, or Gemini CLI, from a web browser instead of sitting directly at the machine running them. It is built as three connected pieces: a browser page, a central gateway that routes messages, and a small client program that runs on the machine where the actual code and agent tools live. The client manages tmux sessions, a standard terminal multiplexing tool, and each session runs one AI coding agent. When someone opens the browser page, it automatically detects whether they are on a desktop or a phone. On desktop it shows a full terminal window using xterm.js, giving the same experience as being logged into the machine directly. On a phone it switches to a chat style interface instead, showing agent output as message bubbles with a text box to send replies, since a full terminal is awkward to use on a small touchscreen. The gateway sits in the middle and only routes messages between the browser and the client, it never sees or stores the actual code being worked on, which stays entirely on the machine running the tmux client. This means the gateway can be hosted on a small cloud server while the real work happens on a separate machine, or someone can run the gateway and client together on the same computer for local use. To try it, a person starts the gateway with one command, starts a tmux client agent with another, then opens the gateway's address in a browser. For a self hosted setup, the gateway runs on a server and one or more tmux clients connect to it over a websocket from wherever the actual agent tools are installed. The project is written in Go, requires Go 1.24 or newer and tmux installed on any machine running agents, and compiles down to a small number of static binaries with no other runtime dependencies. It is licensed under Apache-2.0.

Yoink these prompts

Prompt 1
Explain how the gateway, tmux client, and browser pieces of Nexus talk to each other.
Prompt 2
Walk me through starting the gateway and a tmux client agent locally.
Prompt 3
Show me how to deploy the gateway on a server and connect an agent from another machine.
Prompt 4
Help me understand why the browser switches between a terminal view and a chat view.

Frequently asked questions

wtf is nexus?

A browser-based gateway that lets you control AI coding agents like Claude Code or Codex running in tmux sessions from a desktop terminal or phone chat UI.

What language is nexus written in?

Mainly Go. The stack also includes Go, tmux, WebSocket.

What license does nexus use?

Free to use, modify, and distribute, including commercially, as long as you include the license and note any changes made.

How hard is nexus to set up?

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

Who is nexus for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.