termites 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,13 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm view shellgate)",
+      "Bash(npm view termbridge)",
+      "Bash(npm view shellcast)",
+      "Bash(npm view ptyshare)",
+      "Bash(npm view turtleshell)",
+      "Bash(npm view snailshell)",
+      "Bash(npm view crabshell)"
+    ]
+  }
+}

package/README.md

@@ -0,0 +1,63 @@
+# Termites
+
+A web-based terminal with server-client architecture for remote shell access.
+
+## Architecture
+
+```
+┌─────────────────┐     WebSocket      ┌─────────────────┐
+│   Client 1      │◄──────────────────►│                 │
+│   (node-pty)    │                    │                 │
+└─────────────────┘                    │    Server       │
+                                       │  (Web UI)       │◄──► Browser
+┌─────────────────┐     WebSocket      │                 │
+│   Client 2      │◄──────────────────►│                 │
+│   (node-pty)    │                    └─────────────────┘
+└─────────────────┘
+```
+
+## Installation
+
+```bash
+npm install -g termites
+```
+
+## Usage
+
+### Start Server
+
+```bash
+termites server
+```
+
+The server starts on port 3456 by default. Access the web UI at `http://localhost:3456`.
+
+To use a different port:
+
+```bash
+PORT=8080 termites server
+```
+
+### Connect Client
+
+```bash
+# Connect to localhost:3456
+termites client
+
+# Connect to a remote server
+termites client 192.168.1.100:3456
+termites client ws://example.com:3456
+```
+
+## Features
+
+- Multi-client support - manage multiple shell sessions from one web interface
+- Mobile-friendly UI with collapsible drawer menu
+- Multiple color themes (Solarized, Monokai, Dracula, Nord, GitHub Dark)
+- Customizable font family and size
+- Auto-reconnect for clients
+- Output buffering for terminal history
+
+## License
+
+MIT

package/bin/termites.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+const path = require('path');
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+function showHelp() {
+    console.log(`
+Termites - Web terminal with server-client architecture
+
+Usage:
+  termites server              Start the server
+  termites client [url]        Connect to a server
+
+Options:
+  PORT=<port>                  Set server port (default: 3456)
+
+Examples:
+  termites server              Start server on port 3456
+  PORT=8080 termites server    Start server on port 8080
+  termites client              Connect to ws://localhost:3456
+  termites client 192.168.1.100:3456
+`);
+}
+
+if (!command || command === '-h' || command === '--help' || command === 'help') {
+    showHelp();
+    process.exit(0);
+}
+
+const rootDir = path.join(__dirname, '..');
+
+if (command === 'server') {
+    require(path.join(rootDir, 'server.js'));
+} else if (command === 'client') {
+    const serverUrl = args[1] || 'ws://localhost:3456';
+    process.argv = [process.argv[0], path.join(rootDir, 'client.js'), serverUrl];
+    require(path.join(rootDir, 'client.js'));
+} else {
+    console.error(`Unknown command: ${command}`);
+    showHelp();
+    process.exit(1);
+}

package/client.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+const os = require('os');
+const WebSocket = require('ws');
+
+const SHELL = process.env.SHELL || '/bin/bash';
+const SERVER_URL = process.argv[2] || 'ws://localhost:3456/client';
+
+function getSystemInfo() {
+    const username = os.userInfo().username;
+    const hostname = os.hostname();
+    const cwd = process.cwd().replace(os.homedir(), '~');
+    const platform = os.platform();
+    return { username, hostname, cwd, platform };
+}
+
+class WebShellClient {
+    constructor(serverUrl) {
+        this.serverUrl = serverUrl.endsWith('/client') ? serverUrl : serverUrl + '/client';
+        this.ws = null;
+        this.pty = null;
+        this.reconnectDelay = 1000;
+        this.maxReconnectDelay = 30000;
+        this.systemInfo = getSystemInfo();
+
+        this.connect();
+    }
+
+    connect() {
+        console.log(`连接服务器: ${this.serverUrl}`);
+
+        this.ws = new WebSocket(this.serverUrl);
+
+        this.ws.on('open', () => {
+            console.log('已连接到服务器');
+            this.reconnectDelay = 1000;
+
+            // Register with server
+            this.ws.send(JSON.stringify({
+                type: 'register',
+                info: this.systemInfo
+            }));
+
+            // Start shell
+            this.startShell();
+        });
+
+        this.ws.on('message', (message) => {
+            try {
+                const data = JSON.parse(message);
+                this.handleServerMessage(data);
+            } catch (e) {
+                console.error('解析服务器消息失败:', e);
+            }
+        });
+
+        this.ws.on('close', () => {
+            console.log('与服务器断开连接');
+            this.stopShell();
+            this.scheduleReconnect();
+        });
+
+        this.ws.on('error', (err) => {
+            console.error('WebSocket 错误:', err.message);
+        });
+    }
+
+    scheduleReconnect() {
+        console.log(`${this.reconnectDelay / 1000} 秒后重连...`);
+        setTimeout(() => {
+            this.reconnectDelay = Math.min(this.reconnectDelay * 2, this.maxReconnectDelay);
+            this.connect();
+        }, this.reconnectDelay);
+    }
+
+    handleServerMessage(data) {
+        switch (data.type) {
+            case 'input':
+                if (this.pty) {
+                    this.pty.write(data.text);
+                }
+                break;
+
+            case 'resize':
+                if (this.pty) {
+                    this.pty.resize(data.cols, data.rows);
+                }
+                break;
+        }
+    }
+
+    startShell() {
+        if (this.pty) return;
+
+        const pty = require('node-pty');
+        this.pty = pty.spawn(SHELL, ['-l'], {
+            name: 'xterm-256color',
+            cols: 120,
+            rows: 40,
+            cwd: process.cwd(),
+            env: process.env
+        });
+
+        console.log(`Shell 已启动 (PID: ${this.pty.pid})`);
+
+        this.pty.onData((data) => {
+            if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                this.ws.send(JSON.stringify({
+                    type: 'output',
+                    data
+                }));
+            }
+        });
+
+        this.pty.onExit(() => {
+            console.log('Shell 已退出');
+            if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                this.ws.send(JSON.stringify({ type: 'exit' }));
+            }
+            this.pty = null;
+            // Restart shell
+            setTimeout(() => this.startShell(), 1000);
+        });
+    }
+
+    stopShell() {
+        if (this.pty) {
+            this.pty.kill();
+            this.pty = null;
+        }
+    }
+}
+
+// Parse server URL from command line
+let serverUrl = SERVER_URL;
+if (!serverUrl.startsWith('ws://') && !serverUrl.startsWith('wss://')) {
+    serverUrl = 'ws://' + serverUrl;
+}
+
+console.log('WebShell Client');
+console.log(`系统信息: ${getSystemInfo().username}@${getSystemInfo().hostname}`);
+console.log(`Shell: ${SHELL}`);
+
+new WebShellClient(serverUrl);
+
+process.on('SIGINT', () => process.exit(0));
+process.on('SIGTERM', () => process.exit(0));