web-terminal-agent 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,8 @@
 # web-terminal-agent
 
-A lightweight local agent that enables browser-based terminal access to your computer. Use CLI tools like Claude Code through a friendly web interface - no terminal experience required!
+**TerminalMate** - Use AI tools without the tech stuff.
+
+A lightweight local agent that gives you a beautiful web interface to run CLI tools like Claude Code on your computer. No terminal experience required!
 
 ## Quick Start
 
@@ -8,25 +10,24 @@ A lightweight local agent that enables browser-based terminal access to your com
 npx web-terminal-agent
 ```
 
-That's it! The agent will start and you can connect from the web interface.
+That's it! Your browser will open automatically to `http://localhost:3456` with the full web interface.
 
-## What is this?
+## What does it do?
 
-This agent runs on your computer and creates a secure bridge between your browser and your local terminal. It allows web applications to:
+This agent runs on your computer and provides:
 
-- Execute shell commands on your machine
-- Run CLI tools like Claude Code, Clawdbot, etc.
-- Navigate your file system
-- Install development tools
+1. **A beautiful web interface** - No scary terminal, just a friendly UI
+2. **Access to AI tools** - Run Claude Code, Clawdbot, and more through simple buttons
+3. **Full terminal power** - When you need it, the terminal is there
 
 ## Security
 
 **Your security is our priority:**
 
-- ✅ **Localhost only** - The agent only listens on `127.0.0.1` (your computer). It cannot be accessed from the internet or other devices.
-- ✅ **You're in control** - You start and stop the agent whenever you want. Just press `Ctrl+C` to stop.
-- ✅ **Transparent** - All commands are logged in your terminal so you can see exactly what's happening.
-- ✅ **Open source** - The code is fully visible and auditable.
+- ✅ **Localhost only** - The agent only listens on `127.0.0.1` (your computer). It cannot be accessed from the internet.
+- ✅ **You're in control** - Start and stop anytime with `Ctrl+C`
+- ✅ **Transparent** - All commands are logged so you can see what's happening
+- ✅ **Open source** - The code is fully visible
 
 ## Installation Options
 
@@ -43,72 +44,51 @@ npm install -g web-terminal-agent
 web-terminal-agent
 ```
 
-### Option 3: Clone and run
+## Configuration
+
+### Change the port
 
 ```bash
-git clone https://github.com/user/web-terminal-agent.git
-cd web-terminal-agent
-npm install
-node index.js
+PORT=8080 npx web-terminal-agent
 ```
 
-## Configuration
-
-By default, the agent runs on port `3456`. You can change this:
+### Disable auto-open browser
 
 ```bash
-PORT=8080 npx web-terminal-agent
+NO_BROWSER=1 npx web-terminal-agent
 ```
 
 ## Requirements
 
 - Node.js 18 or higher
-- Works on Windows, macOS, and Linux
+- Works on **Windows**, **macOS**, and **Linux**
 
 ## How it works
 
-1. You run the agent on your computer
-2. The agent starts a local server on `http://127.0.0.1:3456`
-3. The web interface connects to this local server
-4. Commands from the web interface are executed on your machine
-5. Output is streamed back to the web interface in real-time
-
-## API Endpoints
-
-If you want to integrate with the agent programmatically:
-
-- `GET /health` - Check if agent is running
-- `GET /cwd` - Get current working directory
-- `POST /execute` - Execute a command (body: `{ "command": "ls -la" }`)
-- `GET /tools/:tool` - Check if a tool is installed
-- `POST /tools/:tool/install` - Install a tool
-- `WebSocket /ws` - Real-time command execution
+1. You run `npx web-terminal-agent`
+2. The agent starts a local server on `http://localhost:3456`
+3. Your browser opens automatically
+4. Use the friendly web interface to run AI tools
+5. Press `Ctrl+C` to stop when you're done
 
 ## Troubleshooting
 
 ### Port already in use
 
-If port 3456 is busy, use a different port:
-
 ```bash
 PORT=3457 npx web-terminal-agent
 ```
 
-### Permission denied
+### Browser didn't open
 
-On macOS/Linux, you might need to make the script executable:
+Open `http://localhost:3456` manually in your browser.
+
+### Permission denied (Mac/Linux)
 
 ```bash
 chmod +x ./node_modules/.bin/web-terminal-agent
 ```
 
-### Connection refused in browser
-
-Make sure:
-1. The agent is running (you should see the banner in your terminal)
-2. You're connecting to `http://localhost:3456` (not `127.0.0.1` in some browsers)
-3. No firewall is blocking localhost connections
-
 ## License
 
 MIT

package/index.js

@@ -4,7 +4,7 @@
  * Web Terminal Agent
  * 
  * A lightweight local server that enables browser-based terminal access.
- * Runs on localhost only for security.
+ * Serves both the web interface and the API on localhost.
  * 
  * Usage: npx web-terminal-agent
  *        node index.js
@@ -18,6 +18,7 @@ const { spawn, exec } = require('child_process');
 const http = require('http');
 const os = require('os');
 const path = require('path');
+const fs = require('fs');
 
 // Configuration
 const PORT = process.env.PORT || 3456;
@@ -31,23 +32,25 @@ const colors = {
   cyan: '\x1b[36m',
   red: '\x1b[31m',
   dim: '\x1b[2m',
+  bold: '\x1b[1m',
 };
 
 // Print banner
 function printBanner() {
   console.log(`
-${colors.green}╔═══════════════════════════════════════════════════════════╗
-║                                                               ║
-║   ${colors.cyan}██╗    ██╗███████╗██████╗     ████████╗███████╗██████╗ ███╗   ███╗${colors.green}   ║
-║   ${colors.cyan}██║    ██║██╔════╝██╔══██╗    ╚══██╔══╝██╔════╝██╔══██╗████╗ ████║${colors.green}   ║
-║   ${colors.cyan}██║ █╗ ██║█████╗  ██████╔╝       ██║   █████╗  ██████╔╝██╔████╔██║${colors.green}   ║
-║   ${colors.cyan}██║███╗██║██╔══╝  ██╔══██╗       ██║   ██╔══╝  ██╔══██╗██║╚██╔╝██║${colors.green}   ║
-║   ${colors.cyan}╚███╔███╔╝███████╗██████╔╝       ██║   ███████╗██║  ██║██║ ╚═╝ ██║${colors.green}   ║
-║   ${colors.cyan} ╚══╝╚══╝ ╚══════╝╚═════╝        ╚═╝   ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝${colors.green}   ║
-║                                                               ║
-║                    ${colors.yellow}LOCAL AGENT v1.0.0${colors.green}                         ║
-║                                                               ║
-╚═══════════════════════════════════════════════════════════════╝${colors.reset}
+${colors.cyan}╔═══════════════════════════════════════════════════════════════╗
+║                                                                   ║
+║   ${colors.bold}████████╗███████╗██████╗ ███╗   ███╗██╗███╗   ██╗ █████╗ ██╗     ${colors.cyan}║
+║   ${colors.bold}╚══██╔══╝██╔════╝██╔══██╗████╗ ████║██║████╗  ██║██╔══██╗██║     ${colors.cyan}║
+║   ${colors.bold}   ██║   █████╗  ██████╔╝██╔████╔██║██║██╔██╗ ██║███████║██║     ${colors.cyan}║
+║   ${colors.bold}   ██║   ██╔══╝  ██╔══██╗██║╚██╔╝██║██║██║╚██╗██║██╔══██║██║     ${colors.cyan}║
+║   ${colors.bold}   ██║   ███████╗██║  ██║██║ ╚═╝ ██║██║██║ ╚████║██║  ██║███████╗${colors.cyan}║
+║   ${colors.bold}   ╚═╝   ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝${colors.cyan}║
+║                                                                   ║
+║                      ${colors.yellow}MATE v1.0.0${colors.cyan}                                ║
+║                  ${colors.dim}AI tools made simple${colors.cyan}                            ║
+║                                                                   ║
+╚═══════════════════════════════════════════════════════════════════╝${colors.reset}
 `);
 }
 
@@ -64,9 +67,20 @@ function getShortDir(dir) {
 
 // Detect platform
 const isWindows = process.platform === 'win32';
+const isMac = process.platform === 'darwin';
 const shell = isWindows ? 'cmd.exe' : (process.env.SHELL || '/bin/bash');
 const shellArgs = isWindows ? ['/c'] : ['-c'];
 
+// Open browser
+function openBrowser(url) {
+  const command = isWindows ? 'start' : isMac ? 'open' : 'xdg-open';
+  exec(`${command} ${url}`, (error) => {
+    if (error) {
+      console.log(`${colors.yellow}!${colors.reset} Could not auto-open browser. Please open manually: ${colors.cyan}${url}${colors.reset}`);
+    }
+  });
+}
+
 // Check if a command/tool is installed
 async function checkToolInstalled(command) {
   return new Promise((resolve) => {
@@ -197,12 +211,20 @@ function executeCommand(command, ws) {
 
 // Create Express app
 const app = express();
+
+// Enhanced CORS configuration
 app.use(cors({
-  origin: '*', // Allow all origins since we're on localhost
-  methods: ['GET', 'POST'],
+  origin: true,
+  methods: ['GET', 'POST', 'OPTIONS'],
+  allowedHeaders: ['Content-Type', 'Authorization', 'X-Requested-With'],
+  credentials: true,
 }));
+
+app.options('*', cors());
 app.use(express.json());
 
+// API Routes (before static files)
+
 // Health check endpoint
 app.get('/health', (req, res) => {
   res.json({
@@ -252,6 +274,47 @@ app.get('/cwd', (req, res) => {
   res.json({ cwd: getShortDir(currentDir) });
 });
 
+// Serve static files from the 'public' directory
+const publicDir = path.join(__dirname, 'public');
+if (fs.existsSync(publicDir)) {
+  app.use(express.static(publicDir));
+  
+  // SPA fallback - serve index.html for all non-API routes
+  app.get('*', (req, res) => {
+    // Don't serve index.html for API routes
+    if (req.path.startsWith('/api/') || req.path === '/health' || req.path === '/cwd' || req.path.startsWith('/tools/')) {
+      return res.status(404).json({ error: 'Not found' });
+    }
+    res.sendFile(path.join(publicDir, 'index.html'));
+  });
+} else {
+  // No public directory - show a simple landing page
+  app.get('/', (req, res) => {
+    res.send(`
+      <!DOCTYPE html>
+      <html>
+        <head>
+          <title>TerminalMate Agent</title>
+          <style>
+            body { font-family: system-ui, sans-serif; max-width: 600px; margin: 100px auto; padding: 20px; text-align: center; }
+            h1 { color: #6366f1; }
+            code { background: #f3f4f6; padding: 8px 16px; border-radius: 8px; display: inline-block; }
+          </style>
+        </head>
+        <body>
+          <h1>🚀 TerminalMate Agent Running</h1>
+          <p>The agent is running successfully!</p>
+          <p>API available at:</p>
+          <code>http://localhost:${PORT}</code>
+          <p style="margin-top: 40px; color: #666;">
+            To use the full web interface, please download the complete package.
+          </p>
+        </body>
+      </html>
+    `);
+  });
+}
+
 // Create HTTP server
 const server = http.createServer(app);
 
@@ -290,19 +353,28 @@ wss.on('connection', (ws) => {
 server.listen(PORT, HOST, () => {
   printBanner();
   
-  console.log(`${colors.green}✓${colors.reset} Agent running on ${colors.cyan}http://${HOST}:${PORT}${colors.reset}`);
-  console.log(`${colors.green}✓${colors.reset} WebSocket available at ${colors.cyan}ws://${HOST}:${PORT}/ws${colors.reset}`);
+  const url = `http://localhost:${PORT}`;
+  
+  console.log(`${colors.green}✓${colors.reset} Server running at ${colors.cyan}${url}${colors.reset}`);
+  console.log(`${colors.green}✓${colors.reset} WebSocket at ${colors.cyan}ws://localhost:${PORT}/ws${colors.reset}`);
   console.log(`${colors.green}✓${colors.reset} Working directory: ${colors.cyan}${getShortDir(currentDir)}${colors.reset}`);
   console.log('');
-  console.log(`${colors.dim}Press Ctrl+C to stop the agent${colors.reset}`);
+  
+  // Auto-open browser
+  if (!process.env.NO_BROWSER) {
+    console.log(`${colors.dim}Opening browser...${colors.reset}`);
+    setTimeout(() => openBrowser(url), 500);
+  }
+  
+  console.log(`${colors.dim}Press Ctrl+C to stop${colors.reset}`);
   console.log('');
 });
 
 // Handle graceful shutdown
 process.on('SIGINT', () => {
-  console.log(`\n${colors.yellow}Shutting down agent...${colors.reset}`);
+  console.log(`\n${colors.yellow}Shutting down...${colors.reset}`);
   server.close(() => {
-    console.log(`${colors.green}✓${colors.reset} Agent stopped`);
+    console.log(`${colors.green}✓${colors.reset} Stopped`);
     process.exit(0);
   });
 });

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "web-terminal-agent",
-  "version": "1.0.0",
-  "description": "Local agent for Web Terminal - enables browser-based terminal access to your computer. Run CLI tools like Claude Code through a friendly web interface.",
+  "version": "1.1.0",
+  "description": "Local agent for TerminalMate - enables browser-based terminal access to your computer. Run CLI tools like Claude Code through a friendly web interface.",
   "main": "index.js",
   "bin": {
-    "web-terminal-agent": "index.js"
+    "web-terminal-agent": "./index.js"
   },
   "scripts": {
     "start": "node index.js"
@@ -18,7 +18,8 @@
     "claude-code",
     "browser-terminal",
     "remote-terminal",
-    "web-terminal"
+    "web-terminal",
+    "ai-tools"
   ],
   "author": "",
   "license": "MIT",
@@ -40,6 +41,7 @@
   },
   "files": [
     "index.js",
+    "public/**/*",
     "README.md"
   ]
 }