whatisgithub

What is eternalterminal?

mistertea/eternalterminal — explained in plain English

Analysis updated 2026-05-18

3,632C++Audience · developerComplexity · 2/5Setup · moderate

In one sentence

Eternal Terminal is a remote shell like SSH that automatically reconnects your session after network drops, IP changes, or laptop sleep.

Mindmap

mindmap
  root((EternalTerminal))
    What it does
      Reconnecting remote shell
      Survives network drops
      Survives IP changes
      Survives sleep and wake
    Tech stack
      C plus plus
      SSH
      TCP
      CMake
    Use cases
      Flaky network sessions
      Laptop sleep wake
      Jump host access
      Port forwarding
    Audience
      Developers
      Sysadmins
      Remote workers

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

Keep a remote terminal session alive across flaky wifi, VPN drops, or switching networks.

USE CASE 2

Reconnect to a long-running remote session on a laptop after it sleeps and wakes.

USE CASE 3

Reach machines behind a firewall using jump host support with your existing SSH config aliases.

USE CASE 4

Forward ports through the same connection used for the remote shell session.

What is it built with?

C++SSHTCPCMake

How does it compare?

mistertea/eternalterminalckb-next/ckb-nextfrictionalgames/amnesiathedarkdescent
Stars3,6323,6313,635
LanguageC++C++C++
Setup difficultymoderatemoderatehard
Complexity2/53/54/5
Audiencedevelopergeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires existing SSH access to the remote host plus an open TCP port (2022 by default) for the client-server connection.

No license terms are stated in the README.

So what is it?

Eternal Terminal is a remote shell tool that keeps your terminal session alive even when your network connection drops. With a regular SSH connection, losing your internet for a moment closes the session and you have to log back in and restart whatever you were doing. Eternal Terminal reconnects automatically in the background so your session resumes right where it left off. The command you use to connect looks similar to SSH. You run et user@hostname instead of ssh user@hostname, and it handles the rest. Under the hood it still uses SSH for the initial handshake and for encryption, so you need SSH access to the remote machine first. Once connected, your session continues through network interruptions, IP address changes, or laptop sleep and wake cycles. Beyond reconnection, the tool supports port forwarding, jump hosts for reaching machines behind a firewall, and reading standard SSH config files so you can reuse any host aliases you have already set up. It listens on port 2022 by default, which is configurable. Installation is available through the standard package managers on most platforms. On macOS you can use Homebrew. Ubuntu and Debian have dedicated package repositories. Fedora, CentOS 8, FreeBSD, and openSUSE all have it in their official or extra package collections. On Windows it works through WSL, the Windows Subsystem for Linux. Building from source is also documented for systems without a prebuilt package. The server component runs as a background service and can be set to start automatically at boot. Once both the client and server are installed, you verify the setup with a quick which command and a service status check, then you are ready to connect.

Copy-paste prompts

Prompt 1
Show me how to install Eternal Terminal (et) on Ubuntu and connect to a remote server.
Prompt 2
Explain how Eternal Terminal keeps a session alive compared to a normal SSH connection.
Prompt 3
How do I set up Eternal Terminal to connect through a jump host using my SSH config file?
Prompt 4
Write the systemd commands to enable and check the status of the etserver service.

Frequently asked questions

What is eternalterminal?

Eternal Terminal is a remote shell like SSH that automatically reconnects your session after network drops, IP changes, or laptop sleep.

What language is eternalterminal written in?

Mainly C++. The stack also includes C++, SSH, TCP.

What license does eternalterminal use?

No license terms are stated in the README.

How hard is eternalterminal to set up?

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

Who is eternalterminal for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.