projects/cluterm

CluTerm

formerly CludCode

Your machines, as one encrypted computer

All your machines act as one end-to-end encrypted computer you open in a browser. Terminals, files, containers, screen share with remote input, and your own AI across all of it. The relay carries the traffic and holds no key. Every session agrees its keys with a post-quantum hybrid, and when the internet is gone the same session rides the local network or a LoRa radio. A Rust agent on every machine, a web client, a desktop app.

The problem

You're on your phone or a tablet. You need to run something on your dev machine — deploy a fix, check logs, run Claude Code. SSH is painful on mobile. VS Code Remote requires a full IDE. CluTerm gives you every machine you own in your browser, with end-to-end encryption and zero configuration.

How it works

  1. Install a lightweight agent on your machine (curl | sh, auto-updates)

  2. The agent dials out to the relay over WebSocket — no port forwarding, no open ports

  3. AES-256-GCM end to end, with keys agreed per session over X-Wing, a hybrid of X25519 and ML-KEM-768 — the relay sees ciphertext and routing metadata only

  4. Open cluterm.com in any browser, on any device

  5. Sessions start on the relay, then upgrade to a direct WebRTC path — LAN or peer-to-peer, with TURN in between

  6. The Rig: every machine, terminal, container, and file view in one workspace

  7. Screen share with remote input — H.264 frames and keystrokes travel peer-to-peer over WebRTC, never through the relay

  8. Between your own machines with no internet at all — the same session runs over the local network, or over a LoRa radio at a few hundred bytes a second

In action

Screens from the CludCode era, before the rename.

Architecture

Components that never have to trust each other. The relay is a zero-knowledge proxy: it forwards encrypted bytes without ever holding a key. Each device key is generated on the machine and never leaves it.

your screens: Browser (cluterm.com, on any device), Desktop app (Electron). Relay (Node.js · forwards ciphertext, holds no key). Rust agent, on every machine: Terminals (native PTY multiplexer), Files (tree + editor, stays on disk), Containers (Apple container · Podman · Docker), Screen (H.264 over WebRTC), MCP server (40+ tools for Claude). WebRTC direct path: LAN or peer-to-peer, TURN in between. Terminals upgrade to it; screen share lives on it.

  • Device keys live in the OS keystore: Keychain, Secret Service, DPAPI.
  • Off the internet, the same session runs over the LAN or a LoRa radio. The radio gets no handshake of its own.
The relay forwards ciphertext and routing metadata, nothing else. Sessions start there and move to a direct path whenever one exists.

Key decisions

  1. Agent initiates outbound

    no port forwarding, no firewall config, works behind any NAT

  2. Per-session forward secrecy

    a fresh hybrid key for every session, so compromising one reveals nothing about the others

  3. Post-quantum is not optional

    every initiator dials X-Wing and every responder refuses the classical handshake, so no hint from a server can downgrade a session

  4. The protocol is model-checked

    Tamarin models with the relay, the website and the database as the adversary; every attack the prover found is replayed as a test against the real code

  5. Agent rewritten from Bun to Rust

    one static binary across macOS, Linux, and Windows, lower memory, no runtime to ship

  6. Relay first, direct second

    every session connects instantly through the relay, then moves to the fastest direct path it can find

  7. A native Rust PTY multiplexer replaced tmux as the default

    one less dependency on every machine

  8. MCP server on every agent

    40+ tools across terminals, files, and containers, registered in Claude Code automatically

  9. Security audits close classes, not instances

    host-input and credential-state holes made impossible by construction

  10. The radio is a dumb pipe

    LoRa carries the unchanged session in 228-byte fragments, and refuses a terminal stream by name instead of queueing it

  11. The installer verifies the release signature and fails closed

    written natively where the OS ships no Ed25519, with no switch to skip it

Field notes