MidTerm

Your terminal, anywhere. Run AI coding agents and TUI apps on your machine, access them from any browser.

---

Project maintained by tlbx-ai Hosted on GitHub Pages — Theme by mattgraham

MidTerm

Your terminal, anywhere. Run AI coding agents and TUI apps on your machine, access them from any browser.

The Problem

You kick off Claude Code on a complex refactor. It’s going to take a while. Now you need to leave your desk — grab lunch, head to a meeting, go home. Your options:

• Cloud terminals — Expensive, resource-limited, your API keys live on someone else’s server
• SSH — Blocked by firewalls, corporate networks, coffee shop WiFi
• Just wait — Watch the terminal until it’s done

The Solution

MidTerm serves your terminal through a browser. Start a task on your main rig, continue watching from your laptop, phone, or tablet. Your machine does the work. You stay connected.

Your PC                          Anywhere
┌─────────────────┐              ┌─────────────────┐
│ Claude Code     │    HTTPS     │                 │
│ OpenAI Codex    │◄────────────►│   Browser       │
│ Any TUI app     │   WebSocket  │                 │
└─────────────────┘              └─────────────────┘
     Full power                    Full access

Perfect for:

• AI coding agents — Claude Code, OpenAI Codex, Aider, Cursor CLI
• Long-running tasks — Builds, deployments, data processing
• Any TUI app — htop, vim, tmux sessions, whatever you run in a terminal

Features

• Single binary — ~15MB, no dependencies, no runtime
• Cross-platform — macOS, Windows, Linux (Native AOT compiled)
• Password protected — PBKDF2 hashed password, required during install
• Multi-session — Multiple terminals, one WebSocket connection
• Priority multiplexing — Active terminal gets instant delivery, background sessions batch efficiently
• Manual resize — Fit terminal to any screen size with one click
• Any shell — Zsh, Bash, PowerShell, CMD
• Auto-update — One-click update from the UI, page reloads automatically
• Multi-pane layout — Split terminals side-by-side, tmux-style
• Tmux compatibility — AI coding tools that detect tmux work out of the box
• Manager bar — Customizable quick-action buttons for common commands
• Clipboard image paste — Alt+V to inject clipboard images into terminal
• Installable (PWA) — Add to home screen on mobile, standalone window on desktop
• Responsive UI — Works on any screen size

Installation

One-liner Install

macOS / Linux:

curl -fsSL https://tlbx-ai.github.io/MidTerm/install.sh | bash

Windows (PowerShell 5.1+ or pwsh):

irm https://tlbx-ai.github.io/MidTerm/install.ps1 | iex

Windows (cmd):

powershell -c "irm https://tlbx-ai.github.io/MidTerm/install.ps1 | iex"

The installer will:

1. Ask you to choose between system service or user install
2. Prompt for a password (required — protects your terminal from network access)

Option	Best for	Privileges
System service	Always-on access, headless machines, remote access before login	Requires admin/sudo
User install	Try it out, occasional use, no admin rights	No special permissions

Manual Download

Platform	Download
macOS ARM64	mm-osx-arm64.tar.gz
macOS x64	mm-osx-x64.tar.gz
Windows x64	mm-win-x64.zip
Linux x64	mm-linux-x64.tar.gz

Quick Start

1. Run the one-liner install above
2. Open http://localhost:2000 (or the port you chose during setup)
3. Click the + button to create a new terminal
4. Enjoy working on your terminal from anywhere

Security

MidTerm exposes terminal access over the network. Security is mandatory:

• Password required — Set during installation, cannot be skipped
• PBKDF2 hashing — 100,000 iterations with SHA256
• Session cookies — 3-week validity with sliding expiration
• Rate limiting — Lockout after failed login attempts

Change your password anytime in Settings > Security.

Terminal Resize

Terminals are created at the optimal size for your current screen. When viewing from a different device:

• Click the resize button (⤢) in the sidebar to fit the terminal to your current screen
• Each terminal maintains its own dimensions
• Resizing one terminal doesn’t affect others

Remote Access

For access outside your local network:

Tailscale — The easiest option. Install on your machine and phone, access via http://your-machine:2000. Free for personal use.

Other options:

• Cloudflare Tunnel — Free, no port forwarding needed
• Reverse proxy — nginx/Caddy with HTTPS

Command Line Options

mm [options]

  --port 2000       Port to listen on (default: 2000)
  --bind 0.0.0.0    Address to bind to (default: 0.0.0.0)
  --version         Show version and exit
  --hash-password   Hash a password for settings.json

Configuration

Settings stored in:

• Service mode: %ProgramData%\MidTerm\settings.json (Windows) or /usr/local/etc/MidTerm/settings.json (Unix)
• User mode: ~/.MidTerm/settings.json

{
  "defaultShell": "Pwsh",
  "defaultCols": 120,
  "defaultRows": 30,
  "authenticationEnabled": true,
  "passwordHash": "$PBKDF2$100000$..."
}

Building from Source

Prerequisites:

• .NET 10 SDK
• esbuild — TypeScript bundler, must be in PATH
  • Windows: winget install esbuild or download from releases
  • macOS: brew install esbuild
  • Linux: Download from releases

git clone https://github.com/tlbx-ai/MidTerm.git
cd MidTerm

# Build
dotnet build src/Ai.Tlbx.MidTerm/Ai.Tlbx.MidTerm.csproj

# AOT binary (platform-specific)
cd src/Ai.Tlbx.MidTerm
./build-aot-macos.sh     # macOS
./build-aot.cmd          # Windows
./build-aot-linux.sh     # Linux

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Note: All contributions require acceptance of our Contributor License Agreement.

License

GNU Affero General Public License v3.0

Commercial licensing available — contact for details.

---

Created by Johannes Schmidt