v1.0.1 — now on npm

Share your terminal, instantly.

Run one command. Get two links — one to control, one to watch. No SSH, no screen sharing, no installs on the other end.

$npx @sheltr_/agent
sheltr — zsh
~ $ npx @sheltr_/agent
Spawned zsh shell
Connecting to server...
✓ Connected. Session ready.
Controller https://sheltr.dev/s/f3a9c2?role=controller
Viewer https://sheltr.dev/s/f3a9c2?role=viewer
~ $

how it works

Three steps. No setup required.

The fastest path from install to a shared terminal session.

01

Run the agent

Install nothing. Run npx @sheltr_/agent and get two shareable URLs instantly.

02

Share the link

Send the controller link to a teammate or the viewer link to anyone who just needs to watch.

03

Connect instantly

They open a URL in any browser. No SSH, no installs. A full terminal — live.

features

Built for real workflows.

Not another screen share. A purpose-built tool for developers who work remotely.

🔗

Shareable links

Two URLs per session — controller and viewer. Share selectively. No accounts needed.

👁

Role-based access

Viewers watch but can't type. Controllers have full access. Enforced server-side.

Session replay

Every session recorded automatically. When it ends, get a shareable replay link.

🔄

Auto-reconnect

The agent reconnects automatically on network drops. Sessions survive brief outages.

🖥

Real terminal

Full PTY — vim, htop, colors, resize. Not a fake shell. Your actual machine.

🔒

Relay architecture

Your shell stays on your machine. The server only relays bytes — never touches your PTY.

architecture

How it actually works.

Your shell never leaves your machine. The server is just a relay.

Your machinesheltr agentWebSocket (outbound)
Sheltr serverrelaysession managerrecording
Browser A (controller) → xterm.jsfull control
Browser B (viewer) → xterm.jsread only

get started

Ready to share your terminal?

One command. Works on Linux and macOS. Free and open source.

$npx @sheltr_/agent
node-ptywebsocketsxterm.jsnext.jspostgresqltypescriptturborepo
view on github