aigo 1.0.0 → 1.1.0

package/Makefile

@@ -0,0 +1,4 @@
+.PHONY: publish-minor
+publish-minor:
+	npm version minor
+	npm publish

package/README.md

@@ -1,8 +1,8 @@
-# vigo
+# aigo
 
 Stream AI coding assistants to the web - run Claude Code or Cursor Agent remotely from any device.
 
-**vigo** wraps Claude Code or Cursor Agent in a tmux session and streams it to your browser via WebSocket, letting you access your AI coding sessions from your phone, tablet, or any browser.
+**aigo** wraps Claude Code or Cursor Agent in a tmux session and streams it to your browser via WebSocket, letting you access your AI coding sessions from your phone, tablet, or any browser.
 
 ## Quick Start
 
@@ -14,13 +14,13 @@ npm install
 npm link
 
 # Start Claude Code with web access (ngrok tunnel enabled by default)
-vigo claude
+aigo claude
 
 # Or start Cursor Agent
-vigo cursor
+aigo cursor
 
 # Local only (no tunnel)
-vigo --tunnel none claude
+aigo --tunnel none claude
 ```
 
 ## Requirements
@@ -29,7 +29,8 @@ vigo --tunnel none claude
 - **tmux** installed and in PATH
 - **Claude Code CLI** installed (`claude` command) - for Claude Code support
 - **Cursor Agent CLI** installed (`agent` command) - for Cursor support
-- **ngrok** (required for default remote access) - sign up at [ngrok.com](https://ngrok.com)
+- **ngrok** (default for remote access) - sign up at [ngrok.com](https://ngrok.com)
+- **cloudflared** (alternative to ngrok) - free, no signup required
 
 ### Installing tmux
 
@@ -56,6 +57,23 @@ brew install ngrok
 ngrok config add-authtoken YOUR_TOKEN
 ```
 
+### Installing cloudflared
+
+cloudflared is a free alternative to ngrok that doesn't require signup:
+
+```bash
+# macOS
+brew install cloudflared
+
+# Ubuntu/Debian
+curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb -o cloudflared.deb
+sudo dpkg -i cloudflared.deb
+
+# Or download from https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/
+```
+
+No authentication required for quick tunnels (trycloudflare.com).
+
 ### Installing Cursor Agent CLI
 
 ```bash
@@ -72,10 +90,10 @@ export CURSOR_API_KEY=your_api_key_here
 ## Usage
 
 ```
-vigo [options] claude [claude-args]
-vigo [options] cursor [cursor-args]
-vigo [options] agent [agent-args]
-vigo [options] --attach <session>
+aigo [options] claude [claude-args]
+aigo [options] cursor [cursor-args]
+aigo [options] agent [agent-args]
+aigo [options] --attach <session>
 
 Tools:
   claude                    Use Claude Code CLI
@@ -97,26 +115,26 @@ Options:
 
 ```bash
 # Claude Code Examples (ngrok tunnel by default)
-vigo claude                           # Start Claude with ngrok tunnel
-vigo --tunnel none claude             # Local only (no tunnel)
-vigo -p 8080 -s myproject claude      # Custom port and session
-vigo claude --model sonnet            # Pass args to Claude
+aigo claude                           # Start Claude with ngrok tunnel
+aigo --tunnel none claude             # Local only (no tunnel)
+aigo -p 8080 -s myproject claude      # Custom port and session
+aigo claude --model sonnet            # Pass args to Claude
 
 # Cursor Agent Examples
-vigo cursor                           # Start Cursor Agent with ngrok tunnel
-vigo --tunnel cloudflared cursor      # Use cloudflared instead of ngrok
-vigo -p 8080 -s myproject cursor      # Custom port and session
-vigo cursor --model gpt-5             # Pass args to Cursor Agent
+aigo cursor                           # Start Cursor Agent with ngrok tunnel
+aigo --tunnel cloudflared cursor      # Use cloudflared instead of ngrok
+aigo -p 8080 -s myproject cursor      # Custom port and session
+aigo cursor --model gpt-5             # Pass args to Cursor Agent
 
 # General Examples
-vigo --attach myproject               # Attach to existing tmux session
-vigo -P mypass123 claude              # Custom password
-vigo -T 15 -E 30 cursor               # 15min lock, 30min exit timeout
-vigo -T 0 -E 0 claude                 # Disable timeouts (default behavior)
+aigo --attach myproject               # Attach to existing tmux session
+aigo -P mypass123 claude              # Custom password
+aigo -T 15 -E 30 cursor               # 15min lock, 30min exit timeout
+aigo -T 0 -E 0 claude                 # Disable timeouts (default behavior)
 
 # Run multiple sessions (ports auto-selected)
-vigo -s project-a claude              # Gets port 3000
-vigo -s project-b cursor              # Gets port 3001 (auto)
+aigo -s project-a claude              # Gets port 3000
+aigo -s project-b cursor              # Gets port 3001 (auto)
 ```
 
 ## Configuration
@@ -144,17 +162,42 @@ export const config = {
 };
 ```
 
+## Tunnel Options
+
+aigo supports two tunnel providers for remote access:
+
+| Feature | ngrok | cloudflared |
+|---------|-------|-------------|
+| Signup required | Yes | No |
+| Free tier limits | 1 tunnel, rate limits | Unlimited quick tunnels |
+| Custom domains | Paid plans | Requires Cloudflare account |
+| URL format | `*.ngrok-free.app` | `*.trycloudflare.com` |
+| Authentication | Required (authtoken) | Not required |
+
+**Recommendation:** Use cloudflared for quick testing (no signup needed). Use ngrok if you need stable URLs or have an existing account.
+
+```bash
+# Use cloudflared (no signup required)
+aigo --tunnel cloudflared claude
+
+# Use ngrok (default, requires signup)
+aigo claude
+
+# Local only (no tunnel)
+aigo --tunnel none claude
+```
+
 ## How It Works
 
-1. **vigo** creates a tmux session and runs `claude` or `agent` inside it
+1. **aigo** creates a tmux session and runs `claude` or `agent` inside it
 2. A local web server starts, serving an xterm.js terminal
 3. The server attaches to the tmux session via node-pty
 4. Your browser connects via WebSocket for real-time terminal streaming
-5. ngrok creates a public HTTPS tunnel for remote access (default)
+5. A tunnel (ngrok or cloudflared) creates a public HTTPS URL for remote access
 
 ```
 ┌────────────────────────────────────────┐
-│  vigo - Claude Code Web Terminal       │
+│  aigo - Claude Code Web Terminal       │
 ├────────────────────────────────────────┤
 │  Session:  claude-code                 │
 │  Local:    http://localhost:3000       │
@@ -171,7 +214,7 @@ Access URL:
 
 | Feature | Claude Code | Cursor Agent |
 |---------|-------------|--------------|
-| Command | `vigo claude` | `vigo cursor` |
+| Command | `aigo claude` | `aigo cursor` |
 | CLI Binary | `claude` | `agent` |
 | Authentication | Claude API key / OAuth | Browser login or `CURSOR_API_KEY` |
 | Models | Claude models | Multiple (GPT-5, Claude, etc.) via subscription |
@@ -181,7 +224,7 @@ Access URL:
 
 ## Security
 
-vigo uses multiple layers of security:
+aigo uses multiple layers of security:
 
 1. **URL Token** - A random 4-character token in the URL path (`/t/<token>`)
 2. **Password** - A 6-character alphanumeric password (or custom password via `-P`)
@@ -194,17 +237,17 @@ vigo uses multiple layers of security:
 - Password uses unambiguous characters (no 0/O, 1/l/I)
 - Lock screen requires re-entering password after inactivity (when enabled)
 - Session auto-terminates and kills tmux after extended inactivity (when enabled)
-- HTTPS via ngrok (encrypted in transit)
+- HTTPS via tunnel (encrypted in transit)
 
 **Recommendations:**
-- Use HTTPS (ngrok provides this automatically)
+- Use HTTPS (both ngrok and cloudflared provide this automatically)
 - Don't share your access URL or password publicly
 - Use strong custom passwords for sensitive sessions
 - Enable timeouts (`-T 15 -E 30`) for shared or sensitive environments
 
 ## Session Timeouts
 
-vigo has two optional timeout mechanisms (both disabled by default for persistent sessions):
+aigo has two optional timeout mechanisms (both disabled by default for persistent sessions):
 
 ### Lock Timeout (default: disabled)
 When enabled with `-T <minutes>`, the session locks after the specified period of no interaction (mouse movement, typing, etc.) and requires password re-entry. The WebSocket connection stays open, so you don't lose any terminal state.
@@ -215,11 +258,11 @@ When enabled with `-E <minutes>`, the session completely terminates after the sp
 - Claude Code / Cursor Agent is stopped
 - The server exits
 
-Enable timeouts for security in shared environments: `vigo -T 15 -E 30 claude`
+Enable timeouts for security in shared environments: `aigo -T 15 -E 30 claude`
 
 ## Browser Notifications
 
-vigo can send browser notifications when:
+aigo can send browser notifications when:
 - The AI assistant is waiting for input
 - The WebSocket connection is lost
 
@@ -227,10 +270,11 @@ Notifications are only sent when the browser tab is not active. Allow notificati
 
 ## Mobile Controls
 
-When accessing vigo from a mobile device (phone or tablet), control buttons appear at the bottom of the screen:
+When accessing aigo from a mobile device (phone or tablet), control buttons appear at the bottom of the screen:
 
 | Button | Action | Description |
 |--------|--------|-------------|
+| **History** | View Buffer | Opens a fullscreen modal showing the terminal scrollback buffer (useful when TUI scrolling doesn't work on mobile) |
 | **Mode** | `Shift+Tab` | Toggle between chat/edit modes in Claude Code or switch modes in Cursor Agent |
 | **Enter** | `Enter` | Send Enter key to confirm prompts or submit input |
 | **Stop** | `Ctrl+C` | Interrupt the current operation (stop running commands or cancel AI responses) |
@@ -238,6 +282,17 @@ When accessing vigo from a mobile device (phone or tablet), control buttons appe
 
 These buttons are useful because mobile keyboards don't easily support modifier key combinations like Ctrl+C or Shift+Tab.
 
+### History Button
+
+The **History** button is particularly useful on mobile devices where terminal scrolling often doesn't work properly with TUI applications like Claude Code or Cursor Agent. When pressed:
+
+1. Opens a fullscreen modal overlay
+2. Captures the entire terminal scrollback buffer from tmux
+3. Displays the content in a scrollable view with ANSI codes stripped for readability
+4. Press **Close** or the **ESC** key to return to the terminal
+
+This provides an alternative way to review previous AI responses and conversation history without relying on terminal scrolling.
+
 The buttons are automatically shown based on:
 - Touch screen capability
 - Mobile user agent detection
@@ -246,34 +301,34 @@ The buttons are automatically shown based on:
 
 ## Running Persistently
 
-To keep vigo running indefinitely (even after closing your terminal), run it inside tmux or use a process manager:
+To keep aigo running indefinitely (even after closing your terminal), run it inside tmux or use a process manager:
 
 ```bash
-# Run vigo inside its own tmux session
-tmux new-session -d -s vigo-server 'vigo claude'
+# Run aigo inside its own tmux session
+tmux new-session -d -s aigo-server 'aigo claude'
 
 # Attach to check status
-tmux attach -t vigo-server
+tmux attach -t aigo-server
 
 # Or use pm2 for auto-restart on crash
-pm2 start "vigo claude" --name vigo-session
+pm2 start "aigo claude" --name aigo-session
 ```
 
-When the vigo server stays running, your ngrok URL remains stable and you can return to the same URL anytime.
+When the aigo server stays running, your tunnel URL remains stable and you can return to the same URL anytime. Note: cloudflared quick tunnel URLs change on restart, while ngrok URLs persist within a session.
 
 ## Auto Port Selection
 
-If the default port (3000) or your specified port is already in use, vigo automatically finds the next available port:
+If the default port (3000) or your specified port is already in use, aigo automatically finds the next available port:
 
 ```
 ⚠ Port 3000 in use, using port 3001 instead
 ```
 
-This allows running multiple vigo sessions simultaneously without manual port management.
+This allows running multiple aigo sessions simultaneously without manual port management.
 
 ## Exiting and Cleanup
 
-vigo provides different exit behaviors depending on how you terminate the session:
+aigo provides different exit behaviors depending on how you terminate the session:
 
 ### Exit Behavior Summary
 
@@ -290,7 +345,7 @@ Click the **Exit** button in the top-right corner of the web interface to:
 2. Kill the PTY process
 3. Kill the tmux session
 4. Close all WebSocket connections
-5. Shut down the vigo server
+5. Shut down the aigo server
 6. Exit the process
 
 **Result:** Everything is cleaned up - tmux session, server, and process all terminate. The web client shows a "Session Ended" message.
@@ -299,7 +354,7 @@ This is useful when you're completely done with a session and want to free all r
 
 ### Session Persistence (Ctrl+C on console)
 
-When you press `Ctrl+C` on the terminal running vigo:
+When you press `Ctrl+C` on the terminal running aigo:
 1. The web server stops
 2. The tunnel closes (if running)
 3. **The tmux session keeps running!**
@@ -310,9 +365,9 @@ When you press `Ctrl+C` on the terminal running vigo:
 Re-attach later:
 
 ```bash
-# Via vigo (starts new web server for existing session)
-vigo --attach claude-code
-vigo --attach cursor-agent
+# Via aigo (starts new web server for existing session)
+aigo --attach claude-code
+aigo --attach cursor-agent
 
 # Or directly with tmux (local terminal only)
 tmux attach -t claude-code
@@ -401,7 +456,7 @@ ngrok config add-authtoken YOUR_TOKEN
 
 Free ngrok accounts are limited to 1 simultaneous tunnel. If you see this error, it means an ngrok process from a previous session is still running.
 
-vigo will detect this and show you the command to kill it:
+aigo will detect this and show you the command to kill it:
 
 ```
 Error: An ngrok process is already running.
@@ -411,7 +466,7 @@ To kill the existing ngrok process, run:
   kill 12345
 
 Or to run without a tunnel:
-  vigo --tunnel none cursor
+  aigo --tunnel none cursor
 ```
 
 You can also find and kill ngrok manually:
@@ -427,6 +482,21 @@ kill <pid>
 pkill -f "ngrok http"
 ```
 
+### cloudflared connection issues
+
+If cloudflared fails to connect:
+
+```bash
+# Check if cloudflared is installed
+which cloudflared
+
+# Test a quick tunnel manually
+cloudflared tunnel --url http://localhost:3000
+
+# Check for firewall issues (verbose output)
+cloudflared tunnel --url http://localhost:3000 --loglevel debug
+```
+
 ### WebSocket connection fails
 
 - Check that the server is running
@@ -441,13 +511,23 @@ Try resizing your browser window to trigger a terminal resize.
 
 ```bash
 # Run without installing globally
-node bin/vigo.js claude
-node bin/vigo.js cursor
+node bin/aigo.js claude
+node bin/aigo.js cursor
 
 # Watch for changes (requires nodemon)
-npx nodemon bin/vigo.js claude
+npx nodemon bin/aigo.js claude
 ```
 
+### Publishing
+
+Bump the minor version and publish to npm:
+
+```bash
+make publish-minor
+```
+
+This runs `npm version minor` (updates `package.json` and creates a git commit/tag) then `npm publish`.
+
 ## License
 
 MIT

package/bin/vigo.js

@@ -21,7 +21,7 @@ function printBanner(info) {
   const timeoutStr = `lock:${lockStr} exit:${exitStr}`;
 
   const toolTitle = info.tool === 'cursor' ? 'Cursor Agent' : 'Claude Code';
-  const header = `vigo - ${toolTitle} Web Terminal`;
+  const header = `aigo - ${toolTitle} Web Terminal`;
 
   console.log('');
   console.log('┌────────────────────────────────────────┐');
@@ -45,13 +45,13 @@ function printBanner(info) {
 
 function printHelp() {
   console.log(`
-vigo v${VERSION} - Stream Claude Code or Cursor Agent to the web
+aigo v${VERSION} - Stream Claude Code or Cursor Agent to the web
 
 Usage:
-  vigo [options] claude [claude-args]
-  vigo [options] cursor [cursor-args]
-  vigo [options] agent [agent-args]
-  vigo [options] --attach <session>
+  aigo [options] claude [claude-args]
+  aigo [options] cursor [cursor-args]
+  aigo [options] agent [agent-args]
+  aigo [options] --attach <session>
 
 Tools:
   claude                    Use Claude Code CLI
@@ -69,28 +69,28 @@ Options:
   --version, -v             Show version
 
 Examples:
-  vigo claude                           Start Claude Code with ngrok tunnel
-  vigo cursor                           Start Cursor Agent with ngrok tunnel
-  vigo --tunnel none claude             Local only (no tunnel)
-  vigo -p 8080 -s myproject cursor      Custom port and session
-  vigo claude --model sonnet            Pass args to Claude
-  vigo cursor --model gpt-5             Pass args to Cursor Agent
-  vigo --attach myproject               Attach to existing session
-  vigo -P mypass123 cursor              Custom password
+  aigo claude                           Start Claude Code with ngrok tunnel
+  aigo cursor                           Start Cursor Agent with ngrok tunnel
+  aigo --tunnel none claude             Local only (no tunnel)
+  aigo -p 8080 -s myproject cursor      Custom port and session
+  aigo claude --model sonnet            Pass args to Claude
+  aigo cursor --model gpt-5             Pass args to Cursor Agent
+  aigo --attach myproject               Attach to existing session
+  aigo -P mypass123 cursor              Custom password
 `);
 }
 
 async function main() {
-  const { vigoArgs, toolArgs, tool } = parseArgs(process.argv.slice(2));
+  const { aigoArgs, toolArgs, tool } = parseArgs(process.argv.slice(2));
   
   // Handle help and version
-  if (vigoArgs.help) {
+  if (aigoArgs.help) {
     printHelp();
     process.exit(0);
   }
   
-  if (vigoArgs.version) {
-    console.log(`vigo v${VERSION}`);
+  if (aigoArgs.version) {
+    console.log(`aigo v${VERSION}`);
     process.exit(0);
   }
   
@@ -110,7 +110,7 @@ async function main() {
   const toolConfig = config.tools[activeTool];
   
   // Check if the tool CLI is installed (for non-attach mode)
-  if (!vigoArgs.attach && activeTool === 'cursor') {
+  if (!aigoArgs.attach && activeTool === 'cursor') {
     if (!isAgentInstalled()) {
       console.error('Error: Cursor Agent CLI is not installed or not in PATH');
       console.error('');
@@ -135,9 +135,9 @@ async function main() {
     }
   }
   
-  const sessionName = vigoArgs.session || toolConfig.defaultSession;
-  const requestedPort = vigoArgs.port || config.defaultPort;
-  const tunnelType = vigoArgs.tunnel || config.defaultTunnel;
+  const sessionName = aigoArgs.session || toolConfig.defaultSession;
+  const requestedPort = aigoArgs.port || config.defaultPort;
+  const tunnelType = aigoArgs.tunnel || config.defaultTunnel;
   
   // Find available port
   let port;
@@ -156,8 +156,8 @@ async function main() {
   
   // Use custom password or generate password from config
   let password;
-  if (vigoArgs.password) {
-    password = vigoArgs.password;
+  if (aigoArgs.password) {
+    password = aigoArgs.password;
   } else {
     password = '';
     const randomBytes = crypto.randomBytes(config.passwordLength);
@@ -167,12 +167,12 @@ async function main() {
   }
   
   // Timeout settings (in minutes) - use config defaults
-  const lockTimeout = vigoArgs.timeout !== null ? vigoArgs.timeout : config.lockTimeout;
-  const exitTimeout = vigoArgs.exitTimeout !== null ? vigoArgs.exitTimeout : config.exitTimeout;
+  const lockTimeout = aigoArgs.timeout !== null ? aigoArgs.timeout : config.lockTimeout;
+  const exitTimeout = aigoArgs.exitTimeout !== null ? aigoArgs.exitTimeout : config.exitTimeout;
   
   // Handle --attach mode
-  if (vigoArgs.attach) {
-    const attachSession = typeof vigoArgs.attach === 'string' ? vigoArgs.attach : sessionName;
+  if (aigoArgs.attach) {
+    const attachSession = typeof aigoArgs.attach === 'string' ? aigoArgs.attach : sessionName;
     if (!hasSession(attachSession)) {
       console.error(`Error: tmux session '${attachSession}' does not exist`);
       console.error(`Create it first with: tmux new-session -s ${attachSession}`);
@@ -190,7 +190,7 @@ async function main() {
     }
   }
   
-  const actualSession = vigoArgs.attach || sessionName;
+  const actualSession = aigoArgs.attach || sessionName;
   
   // Start web server
   console.log(`✓ Starting web server on port ${port}...`);
@@ -223,7 +223,7 @@ async function main() {
         }
         console.error('');
         console.error('Or to run without a tunnel:');
-        console.error('  vigo --tunnel none cursor');
+        console.error('  aigo --tunnel none cursor');
         console.error('');
         process.exit(1);
       }
@@ -261,7 +261,7 @@ async function main() {
     }
     
     console.log(`tmux session '${actualSession}' is still running.`);
-    console.log(`Re-attach with: vigo --attach ${actualSession}`);
+    console.log(`Re-attach with: aigo --attach ${actualSession}`);
     console.log(`Or directly: tmux attach -t ${actualSession}`);
     server.close();
     process.exit(0);

package/lib/cli.js

@@ -1,15 +1,15 @@
 /**
- * Parse command line arguments, separating vigo args from tool args
+ * Parse command line arguments, separating aigo args from tool args
  * 
- * Example: vigo --port 8080 --tunnel ngrok claude --model sonnet
- * Example: vigo --port 8080 cursor --model gpt-5
+ * Example: aigo --port 8080 --tunnel ngrok claude --model sonnet
+ * Example: aigo --port 8080 cursor --model gpt-5
  * Returns: 
- *   vigoArgs: { port: 8080, tunnel: 'ngrok' }
+ *   aigoArgs: { port: 8080, tunnel: 'ngrok' }
  *   toolArgs: ['--model', 'sonnet']
  *   tool: 'claude' | 'cursor' | null
  */
 export function parseArgs(args) {
-  const vigoArgs = {
+  const aigoArgs = {
     port: null,
     session: null,
     tunnel: null,
@@ -39,31 +39,31 @@ export function parseArgs(args) {
       break;
     }
     
-    // Parse vigo options
+    // Parse aigo options
     if (arg === '--port' || arg === '-p') {
-      vigoArgs.port = parseInt(args[++i], 10);
+      aigoArgs.port = parseInt(args[++i], 10);
     } else if (arg === '--session' || arg === '-s') {
-      vigoArgs.session = args[++i];
+      aigoArgs.session = args[++i];
     } else if (arg === '--tunnel' || arg === '-t') {
-      vigoArgs.tunnel = args[++i];
+      aigoArgs.tunnel = args[++i];
     } else if (arg === '--attach' || arg === '-a') {
       const next = args[i + 1];
       // Check if next arg is a session name (not another flag)
       if (next && !next.startsWith('-')) {
-        vigoArgs.attach = args[++i];
+        aigoArgs.attach = args[++i];
       } else {
-        vigoArgs.attach = true; // Use default session name
+        aigoArgs.attach = true; // Use default session name
       }
     } else if (arg === '--password' || arg === '-P') {
-      vigoArgs.password = args[++i];
+      aigoArgs.password = args[++i];
     } else if (arg === '--timeout' || arg === '-T') {
-      vigoArgs.timeout = parseInt(args[++i], 10);
+      aigoArgs.timeout = parseInt(args[++i], 10);
     } else if (arg === '--exit-timeout' || arg === '-E') {
-      vigoArgs.exitTimeout = parseInt(args[++i], 10);
+      aigoArgs.exitTimeout = parseInt(args[++i], 10);
     } else if (arg === '--help' || arg === '-h') {
-      vigoArgs.help = true;
+      aigoArgs.help = true;
     } else if (arg === '--version' || arg === '-v') {
-      vigoArgs.version = true;
+      aigoArgs.version = true;
     }
     
     i++;
@@ -71,7 +71,7 @@ export function parseArgs(args) {
   
   // For backward compatibility, also export as claudeArgs/foundClaude
   return { 
-    vigoArgs, 
+    aigoArgs, 
     toolArgs, 
     tool,
     // Backward compatibility

package/lib/config.js

@@ -1,7 +1,7 @@
 /**
- * vigo configuration
+ * aigo configuration
  * 
- * Edit these values to customize vigo's default behavior.
+ * Edit these values to customize aigo's default behavior.
  */
 
 export const config = {

package/lib/server.js

@@ -3,6 +3,7 @@ import { createServer } from 'http';
 import { WebSocketServer } from 'ws';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
 import pty from 'node-pty';
 import { getTmuxPath, killSession } from './tmux.js';
 
@@ -234,6 +235,31 @@ export function startServer({ port, token, password, session, lockTimeout, exitT
             }, 500);
             return;
           }
+          
+          // Handle history capture request
+          if (parsed.type === 'capture_history') {
+            updateActivity();
+            try {
+              const tmuxBin = getTmuxPath() || 'tmux';
+              // Capture entire scrollback buffer from tmux session
+              // -p: print to stdout, -S -: start from beginning, -E -: end at bottom
+              const historyData = execSync(
+                `${tmuxBin} capture-pane -t "${session}:0" -p -S - -E -`,
+                { encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 } // 10MB max
+              );
+              ws.send(JSON.stringify({ 
+                type: 'history_data', 
+                data: historyData 
+              }));
+            } catch (err) {
+              console.error('Failed to capture history:', err.message);
+              ws.send(JSON.stringify({ 
+                type: 'history_error', 
+                error: 'Failed to capture terminal history' 
+              }));
+            }
+            return;
+          }
         } catch {
           // Not JSON - treat as terminal input
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aigo",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Stream Claude Code to the web - run Claude remotely from any device",
   "type": "module",
   "bin": {

package/public/index.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
-  <title>vigo - Claude Code Terminal</title>
+  <title>aigo - Claude Code Terminal</title>
   <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>▸</text></svg>">
   
   <!-- xterm.js from CDN (use older compatible CDN paths) -->
@@ -478,12 +478,126 @@
       background: #ff5555;
       color: white;
     }
+    
+    /* History button */
+    #mobile-history-btn {
+      color: #00ffff;
+      border-color: #00ffff;
+    }
+    
+    #mobile-history-btn:hover,
+    #mobile-history-btn:active {
+      background: #00ffff;
+      color: var(--bg-primary);
+    }
+    
+    /* History modal overlay */
+    #history-overlay {
+      display: none;
+      position: fixed;
+      top: 0;
+      left: 0;
+      right: 0;
+      bottom: 0;
+      background: var(--bg-primary);
+      z-index: 300;
+      flex-direction: column;
+    }
+    
+    #history-overlay.visible {
+      display: flex;
+    }
+    
+    .history-header {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      padding: 12px 16px;
+      background: var(--bg-secondary);
+      border-bottom: 1px solid var(--border);
+      flex-shrink: 0;
+    }
+    
+    .history-title {
+      color: #00ffff;
+      font-size: 16px;
+      font-weight: 600;
+    }
+    
+    .history-close-btn {
+      padding: 8px 16px;
+      background: transparent;
+      color: var(--text-secondary);
+      border: 1px solid var(--border);
+      border-radius: 4px;
+      font-family: inherit;
+      font-size: 13px;
+      cursor: pointer;
+      transition: all 0.2s;
+    }
+    
+    .history-close-btn:hover {
+      color: var(--text-primary);
+      border-color: var(--text-primary);
+    }
+    
+    .history-content {
+      flex: 1;
+      overflow-y: auto;
+      padding: 16px;
+      -webkit-overflow-scrolling: touch;
+    }
+    
+    .history-text {
+      white-space: pre-wrap;
+      word-wrap: break-word;
+      font-family: 'SF Mono', 'Fira Code', 'JetBrains Mono', monospace;
+      font-size: 13px;
+      line-height: 1.5;
+      color: var(--text-primary);
+    }
+    
+    .history-loading {
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      height: 100%;
+      color: var(--text-secondary);
+    }
+    
+    .history-loading .spinner {
+      width: 24px;
+      height: 24px;
+      border: 2px solid var(--border);
+      border-top-color: #00ffff;
+      border-radius: 50%;
+      animation: spin 1s linear infinite;
+      margin-right: 12px;
+    }
+    
+    /* Custom scrollbar for history */
+    .history-content::-webkit-scrollbar {
+      width: 8px;
+    }
+    
+    .history-content::-webkit-scrollbar-track {
+      background: var(--bg-primary);
+    }
+    
+    .history-content::-webkit-scrollbar-thumb {
+      background: var(--border);
+      border-radius: 4px;
+    }
+    
+    .history-content::-webkit-scrollbar-thumb:hover {
+      background: #2a2a35;
+    }
   </style>
 </head>
 <body>
   <div id="app">
     <header id="header">
-      <div class="logo">vigo</div>
+      <div class="logo">aigo</div>
       <div class="header-right">
         <div id="status" class="connecting">
           <span class="dot"></span>
@@ -528,11 +642,27 @@
     
     <!-- Mobile control buttons -->
     <div id="mobile-controls">
+      <button id="mobile-history-btn" class="mobile-btn" title="View terminal history">History</button>
       <button id="mobile-mode-toggle" class="mobile-btn" title="Switch mode (Shift+Tab)">Mode</button>
       <button id="mobile-enter-btn" class="mobile-btn" title="Send Enter key">Enter</button>
       <button id="mobile-stop-btn" class="mobile-btn" title="Stop (Ctrl+C)">Stop</button>
       <button id="mobile-exit-btn" class="mobile-btn" title="Exit session">Exit</button>
     </div>
+    
+    <!-- History modal overlay -->
+    <div id="history-overlay">
+      <div class="history-header">
+        <div class="history-title">Terminal History</div>
+        <button id="history-close-btn" class="history-close-btn">Close</button>
+      </div>
+      <div class="history-content">
+        <div class="history-loading">
+          <div class="spinner"></div>
+          <span>Loading history...</span>
+        </div>
+        <pre class="history-text" style="display: none;"></pre>
+      </div>
+    </div>
   </div>
   
   <!-- xterm.js scripts from CDN (non-scoped package names for UMD globals) -->

package/public/terminal.js

@@ -1,5 +1,5 @@
 /**
- * vigo terminal client
+ * aigo terminal client
  * Connects to the WebSocket server and renders the terminal
  */
 
@@ -52,6 +52,12 @@
     const mobileEnterBtn = document.getElementById('mobile-enter-btn');
     const mobileStopBtn = document.getElementById('mobile-stop-btn');
     const mobileExitBtn = document.getElementById('mobile-exit-btn');
+    const mobileHistoryBtn = document.getElementById('mobile-history-btn');
+    const historyOverlay = document.getElementById('history-overlay');
+    const historyCloseBtn = document.getElementById('history-close-btn');
+    const historyContent = historyOverlay.querySelector('.history-content');
+    const historyLoading = historyOverlay.querySelector('.history-loading');
+    const historyText = historyOverlay.querySelector('.history-text');
     
     // Terminal setup
     const terminal = new Terminal({
@@ -261,7 +267,7 @@
         const notification = new Notification(title, {
           body: body,
           icon: 'data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><text y=".9em" font-size="90">▸</text></svg>',
-          tag: 'vigo-notification',
+          tag: 'aigo-notification',
           requireInteraction: false
         });
         
@@ -289,7 +295,7 @@
       // Check patterns
       for (const pattern of idlePatterns) {
         if (pattern.test(outputBuffer)) {
-          showNotification('vigo', 'Claude Code is waiting for input');
+          showNotification('aigo', 'Claude Code is waiting for input');
           outputBuffer = ''; // Reset to avoid repeated notifications
           return;
         }
@@ -453,10 +459,70 @@
       }
     });
     
-    // ESC to close exit confirm
+    // Strip ANSI escape codes from text for clean display
+    function stripAnsiCodes(text) {
+      // Remove ANSI escape sequences (colors, cursor movement, etc.)
+      return text.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '')
+                 .replace(/\x1b\][^\x07]*\x07/g, '')  // OSC sequences
+                 .replace(/\x1b[PX^_].*?\x1b\\/g, '') // DCS, SOS, PM, APC sequences
+                 .replace(/\x1b./g, '');              // Other escape sequences
+    }
+    
+    // Show history modal
+    function showHistoryModal() {
+      historyOverlay.classList.add('visible');
+      historyLoading.style.display = 'flex';
+      historyText.style.display = 'none';
+      historyText.textContent = '';
+      
+      // Request history from server
+      if (ws && ws.readyState === WebSocket.OPEN && authenticated) {
+        ws.send(JSON.stringify({ type: 'capture_history' }));
+      }
+    }
+    
+    // Hide history modal
+    function hideHistoryModal() {
+      historyOverlay.classList.remove('visible');
+      terminal.focus();
+    }
+    
+    // Display history data in the modal
+    function displayHistoryData(data) {
+      historyLoading.style.display = 'none';
+      historyText.style.display = 'block';
+      // Strip ANSI codes for clean, readable text
+      historyText.textContent = stripAnsiCodes(data);
+      // Scroll to bottom to show most recent content
+      historyContent.scrollTop = historyContent.scrollHeight;
+    }
+    
+    // Display history error
+    function displayHistoryError(error) {
+      historyLoading.style.display = 'none';
+      historyText.style.display = 'block';
+      historyText.textContent = `Error: ${error}`;
+    }
+    
+    // Mobile history button handler
+    mobileHistoryBtn.addEventListener('click', () => {
+      if (ws && ws.readyState === WebSocket.OPEN && authenticated && !isLocked) {
+        mobileButtonFeedback(mobileHistoryBtn);
+        showHistoryModal();
+      }
+    });
+    
+    // History close button handler
+    historyCloseBtn.addEventListener('click', hideHistoryModal);
+    
+    // ESC to close exit confirm or history
     document.addEventListener('keydown', (e) => {
-      if (e.key === 'Escape' && exitOverlay.classList.contains('visible')) {
-        hideExitConfirm();
+      if (e.key === 'Escape') {
+        if (historyOverlay.classList.contains('visible')) {
+          hideHistoryModal();
+        } else if (exitOverlay.classList.contains('visible')) {
+          hideExitConfirm();
+        }
       }
     });
     
@@ -606,6 +672,16 @@
               showCleanupComplete();
               return;
             }
+            
+            if (msg.type === 'history_data') {
+              displayHistoryData(msg.data);
+              return;
+            }
+            
+            if (msg.type === 'history_error') {
+              displayHistoryError(msg.error);
+              return;
+            }
           } catch {
             // Not JSON, treat as terminal data
           }
@@ -630,7 +706,7 @@
         
         if (event.code !== 1000) {
           // Notify user of unexpected disconnect
-          showNotification('vigo', 'Connection lost. Attempting to reconnect...');
+          showNotification('aigo', 'Connection lost. Attempting to reconnect...');
           scheduleReconnect();
         } else {
           showOverlay(true, 'Session ended.', true);
@@ -737,7 +813,7 @@
     connect();
     
     // Expose for debugging
-    window.vigoTerminal = {
+    window.aigoTerminal = {
       terminal,
       fitAddon,
       reconnect: () => {

package/specs/claude-code-web-terminal.md

@@ -2,11 +2,11 @@
 
 ## Overview
 
-**vigo** is a CLI tool that lets you run Claude Code remotely from any device. It wraps Claude in a tmux session and streams it to your browser via WebSocket.
+**aigo** is a CLI tool that lets you run Claude Code remotely from any device. It wraps Claude in a tmux session and streams it to your browser via WebSocket.
 
 ```bash
 # Start Claude Code accessible from anywhere
-vigo --tunnel ngrok claude --model sonnet
+aigo --tunnel ngrok claude --model sonnet
 
 # Output:
 # ✓ tmux session: claude-code
@@ -19,8 +19,8 @@ vigo --tunnel ngrok claude --model sonnet
 ## CLI Interface
 
 ```
-vigo [vigo-options] claude [claude-args]
-vigo [vigo-options] --attach <session>
+aigo [aigo-options] claude [claude-args]
+aigo [aigo-options] --attach <session>
 
 Vigo Options:
   --port, -p <port>       Web server port (default: 3000)
@@ -30,19 +30,19 @@ Vigo Options:
   --help, -h              Show help
 
 Examples:
-  vigo claude                           # Basic: start claude in tmux + web server
-  vigo --tunnel ngrok claude            # With ngrok tunnel
-  vigo -p 8080 -s myproject claude      # Custom port and session
-  vigo claude --model sonnet            # Pass args to claude
-  vigo --attach myproject               # Attach to existing session
+  aigo claude                           # Basic: start claude in tmux + web server
+  aigo --tunnel ngrok claude            # With ngrok tunnel
+  aigo -p 8080 -s myproject claude      # Custom port and session
+  aigo claude --model sonnet            # Pass args to claude
+  aigo --attach myproject               # Attach to existing session
 ```
 
 ## Architecture
 
 ```mermaid
 flowchart TB
-    subgraph cli [vigo CLI]
-        CLI[bin/vigo.js]
+    subgraph cli [aigo CLI]
+        CLI[bin/aigo.js]
         CLI --> TMUX_MGR[tmux manager]
         CLI --> SERVER[web server]
         CLI --> TUNNEL[tunnel manager]
@@ -78,10 +78,10 @@ flowchart TB
 ## Project Structure
 
 ```
-vigo/
+aigo/
 ├── package.json              # dependencies + bin entry
 ├── bin/
-│   └── vigo.js               # CLI entry point (#!/usr/bin/env node)
+│   └── aigo.js               # CLI entry point (#!/usr/bin/env node)
 ├── lib/
 │   ├── cli.js                # Argument parsing
 │   ├── tmux.js               # tmux session management
@@ -95,25 +95,25 @@ vigo/
 
 ## Implementation Details
 
-### 1. CLI Entry Point (bin/vigo.js)
+### 1. CLI Entry Point (bin/aigo.js)
 
 - Shebang for direct execution: `#!/usr/bin/env node`
-- Parse arguments, separating vigo args from claude args
+- Parse arguments, separating aigo args from claude args
 - Orchestrate: tmux → server → tunnel (if requested)
 - Handle graceful shutdown (Ctrl+C kills tunnel, keeps tmux alive)
 
 ### 2. Argument Parsing (lib/cli.js)
 
 ```javascript
-// vigo --port 8080 --tunnel ngrok claude --model sonnet --allowedTools Bash
+// aigo --port 8080 --tunnel ngrok claude --model sonnet --allowedTools Bash
 // 
 // Parsed as:
-// vigoArgs = { port: 8080, tunnel: 'ngrok', session: 'claude-code' }
+// aigoArgs = { port: 8080, tunnel: 'ngrok', session: 'claude-code' }
 // claudeArgs = ['--model', 'sonnet', '--allowedTools', 'Bash']
 ```
 
 - Split on `claude` keyword
-- Everything before = vigo options
+- Everything before = aigo options
 - Everything after = passed to claude CLI
 
 ### 3. tmux Manager (lib/tmux.js)
@@ -164,7 +164,7 @@ console.log(`Tunnel URL: ${tunnel.url}`);
 
 ## Token Security
 
-- Generated once per `vigo` invocation
+- Generated once per `aigo` invocation
 - 32 bytes from `crypto.randomBytes()` → 64 char hex
 - Embedded in URL path: `/t/<token>`
 - Required for both HTTP and WebSocket
@@ -176,12 +176,12 @@ console.log(`Tunnel URL: ${tunnel.url}`);
 # 1. Install globally (or use npx)
 npm install -g .
 
-# 2. Run vigo with Claude
-vigo --tunnel ngrok claude --model sonnet
+# 2. Run aigo with Claude
+aigo --tunnel ngrok claude --model sonnet
 
 # 3. Output shows access URL
 # ┌─────────────────────────────────────────────────┐
-# │  vigo - Claude Code Web Terminal                │
+# │  aigo - Claude Code Web Terminal                │
 # ├─────────────────────────────────────────────────┤
 # │  tmux session:  claude-code                     │
 # │  Local server:  http://localhost:3000           │
@@ -194,18 +194,18 @@ vigo --tunnel ngrok claude --model sonnet
 # 4. Open URL on phone/tablet - full Claude Code access!
 
 # 5. Ctrl+C stops server + tunnel, tmux session persists
-#    Re-attach later with: vigo --attach claude-code
+#    Re-attach later with: aigo --attach claude-code
 ```
 
 ## Dependencies
 
 ```json
 {
-  "name": "vigo",
+  "name": "aigo",
   "version": "1.0.0",
   "type": "module",
   "bin": {
-    "vigo": "./bin/vigo.js"
+    "aigo": "./bin/aigo.js"
   },
   "dependencies": {
     "express": "^4.21.0",
@@ -226,14 +226,14 @@ No build step. Frontend loads xterm.js from CDN.
 ### New CLI option
 
 ```bash
-vigo --tunnel relay claude    # Use self-hosted WebRTC relay
+aigo --tunnel relay claude    # Use self-hosted WebRTC relay
 ```
 
 ### Architecture
 
 ```mermaid
 sequenceDiagram
-    participant Local as vigo (local)
+    participant Local as aigo (local)
     participant Signal as Railway Signaling Server
     participant Browser as Mobile Browser
     
@@ -248,7 +248,7 @@ sequenceDiagram
 ### Components to add
 
 1. **Signaling server** (new repo, deploy to Railway)
-2. **WebRTC module** in vigo (`lib/webrtc.js`)
+2. **WebRTC module** in aigo (`lib/webrtc.js`)
 3. **Frontend WebRTC client** 
 
 ### Benefits

package/specs/cursor-cli-support.md

@@ -1,22 +1,22 @@
-# Cursor CLI Support for vigo
+# Cursor CLI Support for aigo
 
 ## Overview
 
-Add support for Cursor Agent CLI alongside Claude Code, allowing vigo to stream either tool to a browser via WebSocket. This enables users with Cursor subscriptions to access Cursor's AI features remotely.
+Add support for Cursor Agent CLI alongside Claude Code, allowing aigo to stream either tool to a browser via WebSocket. This enables users with Cursor subscriptions to access Cursor's AI features remotely.
 
 ## Architecture Comparison
 
 ```mermaid
 flowchart TB
     subgraph current [Current: Claude Code]
-        vigo1[vigo] --> tmux1[tmux session]
+        aigo1[aigo] --> tmux1[tmux session]
         tmux1 --> claude[claude CLI]
         claude --> ws1[WebSocket]
         ws1 --> browser1[Browser xterm.js]
     end
     
     subgraph new [New: Cursor Agent]
-        vigo2[vigo] --> tmux2[tmux session]
+        aigo2[aigo] --> tmux2[tmux session]
         tmux2 --> agent[agent CLI]
         agent --> ws2[WebSocket]
         ws2 --> browser2[Browser xterm.js]
@@ -95,10 +95,10 @@ export function getCursorAgentPath() {
 
 **For Cursor CLI:**
 
-1. **Browser login (recommended for interactive)**: User runs `agent login` before starting vigo
+1. **Browser login (recommended for interactive)**: User runs `agent login` before starting aigo
 2. **API key (for headless/automation)**: Set `CURSOR_API_KEY` environment variable
 
-vigo should:
+aigo should:
 
 - Check if authentication is configured before starting
 - Provide clear error messages if not authenticated
@@ -108,18 +108,18 @@ vigo should:
 
 ```bash
 # Start Claude Code (existing)
-vigo claude
+aigo claude
 
 # Start Cursor Agent (new)
-vigo cursor
+aigo cursor
 # or
-vigo agent
+aigo agent
 
 # With tunnel for remote access
-vigo --tunnel ngrok cursor
+aigo --tunnel ngrok cursor
 
 # Pass arguments to Cursor Agent
-vigo cursor --model gpt-5
+aigo cursor --model gpt-5
 ```
 
 ## Requirements Update
@@ -134,6 +134,6 @@ Add to README:
 
 1. [lib/cli.js](lib/cli.js) - Add cursor/agent command detection
 2. [lib/tmux.js](lib/tmux.js) - Generalize command execution
-3. [bin/vigo.js](bin/vigo.js) - Update startup logic for both tools
+3. [bin/aigo.js](bin/aigo.js) - Update startup logic for both tools
 4. [README.md](README.md) - Document Cursor support
 5. [lib/cursor.js](lib/cursor.js) - Cursor-specific utilities

package/specs/history-view-button.md

@@ -0,0 +1,64 @@
+# History View Button for Mobile
+
+## Problem
+Terminal scrolling doesn't work well on mobile devices with TUI applications like Claude Code and Cursor Agent, making it difficult to view previous messages.
+
+## Solution
+Add a "History" button that opens a modal overlay displaying the terminal scrollback buffer captured directly from tmux using `tmux capture-pane`.
+
+## Architecture
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant Frontend as WebClient
+    participant Server as Node Server
+    participant Tmux
+
+    User->>Frontend: Clicks History button
+    Frontend->>Server: WebSocket message type: "capture_history"
+    Server->>Tmux: capture-pane -t session:0 -p -S - -E -
+    Tmux-->>Server: Scrollback buffer text
+    Server-->>Frontend: WebSocket message type: "history_data"
+    Frontend->>User: Shows modal with scrollable history
+```
+
+## Implementation
+
+### 1. Backend - Add history capture endpoint ([lib/server.js](lib/server.js))
+
+Add a new WebSocket message handler for `capture_history` that runs:
+```bash
+tmux capture-pane -t <session>:0 -p -S - -E -
+```
+
+This captures the entire scrollback buffer (tested and confirmed working - returns all terminal output including Claude/Cursor responses).
+
+### 2. Frontend - Add History button ([public/index.html](public/index.html))
+
+Add a new mobile button styled like the existing controls:
+- Button label: "History"
+- Color: Use a distinct color (cyan `#00ffff`)
+- Position: Add to the existing mobile controls row
+
+### 3. Frontend - Add modal overlay ([public/index.html](public/index.html))
+
+Create a fullscreen modal that:
+- Has a dark background matching the terminal theme
+- Contains a scrollable text area with monospace font
+- Has a "Close" button at the top
+- Strips ANSI escape codes for clean display
+
+### 4. Frontend - Handle history messages ([public/terminal.js](public/terminal.js))
+
+- Send `capture_history` request when History button is clicked
+- Receive `history_data` response and display in modal
+- Strip ANSI escape codes for readable plain text display
+
+## Key Files Modified
+- [lib/server.js](lib/server.js) - Add tmux capture-pane handler
+- [public/index.html](public/index.html) - Add History button and modal HTML/CSS
+- [public/terminal.js](public/terminal.js) - Add click handler and modal logic
+- [README.md](README.md) - Document the new History feature
+
+## Status: Completed