whatisgithub

What is tuiport?

acoyfellow/tuiport — explained in plain English

Analysis updated 2026-05-18

16TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

Tuiport is a starter kit for building terminal apps that users reach over SSH, hosted entirely on Cloudflare Workers and Containers, with a small Go relay bridging the TCP connection gap.

Mindmap

mindmap
  root((tuiport))
    What it does
      SSH terminal app
      Runs on Cloudflare
      Browser demo
      Agent and human access
    Tech stack
      TypeScript
      Cloudflare Workers
      Cloudflare Containers
      OpenTUI
      Go relay
    Use cases
      Shared agent terminal
      Serverless SSH app
      TCP to WebSocket bridge
    Audience
      Developers
      Cloudflare users

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

Build a shared terminal interface where AI agents and human users can connect over SSH to work together.

USE CASE 2

Deploy an SSH-reachable terminal app entirely on Cloudflare's serverless infrastructure without renting a server.

USE CASE 3

Let visitors try a limited version of your terminal app directly in a browser without needing SSH.

USE CASE 4

Learn a pattern for bridging TCP based protocols like SSH into WebSocket based serverless platforms.

What is it built with?

TypeScriptCloudflare WorkersCloudflare ContainersOpenTUIGo

How does it compare?

acoyfellow/tuiportdabao-yi/model-fluxdenjino/horizon-view
Stars161616
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity4/53/52/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Full SSH access needs a separate relay process and a Cloudflare Spectrum TCP application.

Permissive MIT license, use freely for any purpose including commercial use, keeping the copyright notice.

So what is it?

Tuiport is a starter project for building interactive terminal applications that users connect to over SSH, with everything hosted on Cloudflare's infrastructure. SSH is the same protocol you use to log into a remote server from a command line. Instead of a web page with buttons and forms, users open a terminal and type a command like "ssh hostname" to reach an interface that looks like a text-based app. The interface itself is built with a library called OpenTUI, which handles drawing text, colors, and interactive elements inside a terminal window. Tuiport wires OpenTUI together with an SSH server running inside a Cloudflare Container (a way to run small isolated programs on Cloudflare's network). Because Cloudflare's system does not yet support accepting direct incoming TCP connections to containers, the project also includes a small relay component written in Go. That relay sits on any machine with a public address, receives the SSH connection from the user, and forwards the encrypted bytes over a WebSocket connection to the Cloudflare side. The relay cannot read the SSH session contents, it only converts the connection type. There is also a browser-based version of the same terminal application embedded in a landing page. This lets visitors try the interface in a regular web browser without needing SSH, though it is intentionally limited: no shell access, no command execution, no filesystem. Deploying the project is handled by a setup script that logs you into Cloudflare, deploys the Worker and Container, generates the required secrets automatically, and stores them without you needing to paste anything into a web form. A one-click deploy button is also available for the site and browser demo portion, with SSH enabled in a follow-up step. The project is described as a proof-of-concept at version 0.0.1. It is aimed at developers who want to build shared terminal interfaces for both humans and AI agents. The code is open source under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through deploying Tuiport to Cloudflare and connecting to it over SSH for the first time.
Prompt 2
Explain how Tuiport's Go relay bridges SSH TCP traffic into a Cloudflare Worker over WebSockets.
Prompt 3
Show me how to customize the terminal application that Tuiport serves over SSH.
Prompt 4
What secrets does Tuiport's setup script generate, and what does each one protect?

Frequently asked questions

What is tuiport?

Tuiport is a starter kit for building terminal apps that users reach over SSH, hosted entirely on Cloudflare Workers and Containers, with a small Go relay bridging the TCP connection gap.

What language is tuiport written in?

Mainly TypeScript. The stack also includes TypeScript, Cloudflare Workers, Cloudflare Containers.

What license does tuiport use?

Permissive MIT license, use freely for any purpose including commercial use, keeping the copyright notice.

How hard is tuiport to set up?

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

Who is tuiport for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.