remote-terminal

Your terminal, anywhere. Access your dev workspace from browser, Telegram, or AI.

remote-terminal is a secure, portable command center for your codebase. Run commands from your phone, use natural language with AI, or open a full terminal in your browser — all tunneled securely through Tailscale.

Features

• Web Terminal — Full xterm.js terminal in your browser
• Telegram Bot — Run commands from your phone
• LLM Mode — Natural language commands powered by OpenAI
• Tailscale — Secure access from anywhere on your tailnet

Quick Install

git clone https://github.com/chintan-diwakar/remote-terminal.git
cd remote-terminal
npm install
npm start

Open http://localhost:7860 in your browser.

How It Works

┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│   Browser   │  │  Telegram   │  │  Tailscale  │
│  (xterm.js) │  │     Bot     │  │   Tunnel    │
└──────┬──────┘  └──────┬──────┘  └──────┬──────┘
       │                │                │
       └────────────────┼────────────────┘
                        ▼
              ┌─────────────────┐
              │  Express Server │
              │   + WebSocket   │
              └────────┬────────┘
                       ▼
              ┌─────────────────┐
              │    node-pty     │
              │  (PTY sessions) │
              └─────────────────┘

Requirements

• Node.js 18+
• Tailscale (optional, for remote access)
• Telegram Bot Token (optional)
• OpenAI API Key (optional, for LLM mode)

License

MIT License