claude-ws 0.1.9 → 0.1.10

package/README.md

@@ -64,26 +64,30 @@ Local-first SQLite database. Real-time streaming. Plugin system for custom agent
 
 ## Quick Start
 
-### Option 1: Run with npx (Recommended)
+### Option 1: Run with npx
 
 **Prerequisites:** Node.js 20+, pnpm 9+, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
 
 ```bash
-npx claude-ws
+npx -y claude-ws
 ```
 
+The `-y` flag skips the "Ok to proceed?" prompt.
+
 The first run will:
 - Auto-create SQLite database in `~/.claude-ws/`
-- Run migrations automatically
+- Install dependencies and build automatically
 - Start the server on http://localhost:8556
 
-### Option 2: Install globally
+### Option 2: Install globally (Recommended)
 
 ```bash
 npm install -g claude-ws
 claude-ws
 ```
 
+Global installation avoids npx prompts and rebuilding on every run.
+
 ### Option 3: Development from source
 
 ```bash
@@ -98,6 +102,25 @@ Open [http://localhost:8556](http://localhost:8556)
 
 ---
 
+## Updating
+
+### Check current version
+```bash
+claude-ws --version
+```
+
+### Update to latest version
+```bash
+npm update -g claude-ws
+```
+
+### Force reinstall
+```bash
+npm install -g claude-ws@latest
+```
+
+---
+
 ## Tech Stack
 
 - **Framework**: Next.js 16 + React 19

package/bin/claudekanban.js

@@ -17,6 +17,32 @@ const os = require('os');
 // Get package root directory
 const packageRoot = path.resolve(__dirname, '..');
 
+// Handle CLI flags
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  const pkg = require(path.join(packageRoot, 'package.json'));
+  console.log(`v${pkg.version}`);
+  process.exit(0);
+}
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log(`
+Claude Workspace - Visual workspace for Claude Code
+
+Usage:
+  claude-ws [options]
+
+Options:
+  -v, --version    Show version number
+  -h, --help       Show this help message
+
+Examples:
+  claude-ws        Start Claude Workspace server
+
+For more info: https://github.com/Claude-Workspace/claude-ws
+  `);
+  process.exit(0);
+}
+
 // Database path (in user's home directory for persistence)
 const DB_DIR = path.join(os.homedir(), '.claude-ws');
 const DB_PATH = path.join(DB_DIR, 'claude-ws.db');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-ws",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "private": false,
   "description": "A beautifully crafted workspace interface for Claude Code with real-time streaming and local SQLite database",
   "keywords": [
@@ -145,4 +145,4 @@
     "typescript": "^5"
   },
   "packageManager": "pnpm@10.28.0+sha512.05df71d1421f21399e053fde567cea34d446fa02c76571441bfc1c7956e98e363088982d940465fd34480d4d90a0668bc12362f8aa88000a64e83d0b0e47be48"
-}
+}

package/src/lib/update-checker.ts

@@ -0,0 +1,35 @@
+/**
+ * Check for available updates on npm registry
+ * Shows notification if newer version available
+ */
+
+import { execSync } from 'child_process';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+
+export async function checkForUpdates() {
+  try {
+    const pkgPath = join(process.cwd(), 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    const currentVersion = pkg.version;
+
+    // Quick check - don't block startup
+    const latestVersion = execSync('npm show claude-ws version', {
+      encoding: 'utf-8',
+      timeout: 3000,
+      stdio: ['pipe', 'pipe', 'ignore'], // Suppress errors
+    }).trim();
+
+    if (latestVersion && latestVersion !== currentVersion) {
+      console.log('');
+      console.log('\x1b[33m%s\x1b[0m', '┌─────────────────────────────────────────────┐');
+      console.log('\x1b[33m%s\x1b[0m', '│  Update available!                          │');
+      console.log('\x1b[33m%s\x1b[0m', `│  ${currentVersion} → ${latestVersion}                         │`);
+      console.log('\x1b[33m%s\x1b[0m', '│  Run: npm update -g claude-ws               │');
+      console.log('\x1b[33m%s\x1b[0m', '└─────────────────────────────────────────────┘');
+      console.log('');
+    }
+  } catch (error) {
+    // Silently fail - don't block startup for update check
+  }
+}