claude-ws 0.1.8 → 0.1.10

package/README.md

@@ -1,72 +1,93 @@
 # Claude Workspace
 
-**A beautifully crafted workspace interface for Claude Code.**
+**Visual workspace for Claude Code with Kanban board, code editor, and Git integration.**
 
-Powerful workspace for Claude Code. Work from anywhere with consistent performance. Intuitive workflow, flexible plugins.
+Local-first SQLite database. Real-time streaming. Plugin system for custom agents and skills.
 
 ---
 
 ## Why Claude Workspace?
 
-### 🌍 Work Everywhere
-Coffee shop. Airport lounge. Hotel WiFi. Beach with spotty signal. Claude Workspace runs locally with SQLite—no cloud dependency, no latency spikes. Your workflow travels with you.
-
-### ⚡ Consistent Performance
-Same snappy experience whether you're on fiber at home or tethering from your phone. Lightweight footprint. Instant startup. Responsive UI while Claude streams. Performance you can rely on, anywhere.
-
-### 🎯 Unique Workflow
-Each task is a conversation. Each conversation has checkpoints. Rewind to any point, branch off, continue later. Your AI workflow adapts to how you think.
-
-### ✨ Intuitive Management
-Drag-and-drop across columns. Watch responses stream live. Navigate conversation history. File browser with git status. Everything where you expect it.
-
-### 🔌 Flexible Plugins
-Agent Factory manages Claude skills, commands, and agents per project. Install what you need. Your toolkit, your rules.
-
-### 🔋 Powered by Claude Code
-Native CLI integration. Real-time streaming. File attachments. Full persistence. All the power, none of the friction.
+| Feature | Benefit |
+|---------|---------|
+| 🌍 **Work Everywhere** | SQLite-based local storage—no cloud dependency, works offline anywhere |
+| ⚡ **Consistent Performance** | Lightweight footprint, instant startup, responsive UI on any connection |
+| 🎯 **Unique Workflow** | Conversation checkpoints—rewind, branch, and continue at any point |
+| ✨ **Intuitive Management** | Drag-and-drop Kanban, live streaming, file browser with Git status |
+| 🔌 **Flexible Plugins** | Agent Factory—install only the skills and agents your project needs |
+| 🔋 **Claude Code Native** | Full CLI integration with real-time streaming and file attachments |
 
 ---
 
 ## Features
 
-| Feature | Description |
-|---------|-------------|
-| **Task Board** | Drag-and-drop tasks: To Do → In Progress → In Review → Done |
-| **Real-time Streaming** | Watch Claude's responses stream live via Socket.io |
-| **Checkpoints** | Save conversation states, rewind to any point |
-| **Conversation History** | Full attempt logs with ability to continue or branch |
-| **File Browser** | Integrated explorer with search, preview, git status |
-| **Git Integration** | View diffs, commits, and perform git operations |
-| **File Attachments** | Attach files to provide context for prompts |
-| **Multi-Project** | Manage multiple workspaces with separate boards |
-| **Agent Factory** | Discover and manage Claude skills, commands, agents |
-| **Themes** | Light, Dark, VS Code Light/Dark, Dracula |
+**Task Management**
+- Kanban board: To Do → In Progress → In Review → Done → Cancelled
+- Drag-and-drop task cards with auto-save
+- Full conversation history per task
+
+**AI Interaction**
+- Real-time streaming of Claude responses via Socket.io
+- Checkpoints: Save and rewind to any conversation state
+- File attachments for context
+- Custom commands: `/cook`, `/plan`, `/fix`, `/brainstorm`
+- Detachable chat window
+
+**Code Editor**
+- Tabbed CodeMirror editor with syntax highlighting
+- AI-powered inline code suggestions
+- Go-to-definition navigation
+- Multi-file editing
+
+**File System**
+- Interactive file tree browser
+- Unified search (files + content)
+- File preview
+
+**Git Integration**
+- Full Git workflow: status, stage, commit, diff
+- Visual Git graph
+- Checkpoint Git snapshots for time-travel debugging
+
+**Agent Factory**
+- Plugin system for Claude skills, commands, agents
+- Dependency management
+- Per-project plugin installation
+
+**Developer Tools**
+- Background shell process manager
+- Terminal output streaming
+- Multi-project workspace support
+- Themes: Light, Dark, VS Code variants, Dracula
 
 ---
 
 ## 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 claudews
+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 claudews
-claudews
+npm install -g claude-ws
+claude-ws
 ```
 
+Global installation avoids npx prompts and rebuilding on every run.
+
 ### Option 3: Development from source
 
 ```bash
@@ -81,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');
@@ -35,36 +61,43 @@ async function startServer() {
 
   const serverPath = path.join(packageRoot, 'server.ts');
   const nextBuildDir = path.join(packageRoot, '.next');
+  const nodeModulesDir = path.join(packageRoot, 'node_modules');
+
+  // Check if dependencies are installed
+  if (!fs.existsSync(nodeModulesDir) || !fs.existsSync(path.join(nodeModulesDir, 'next'))) {
+    console.log('[Claude Workspace] Installing dependencies...');
+    const { execSync } = require('child_process');
+
+    let installCmd = 'npm install --production=false';
+    try {
+      execSync('which pnpm', { stdio: 'ignore' });
+      installCmd = 'pnpm install --no-frozen-lockfile';
+    } catch {
+      // pnpm not found, use npm
+    }
+
+    try {
+      execSync(installCmd, {
+        cwd: packageRoot,
+        stdio: 'inherit',
+        env: { ...process.env }
+      });
+    } catch (error) {
+      console.error('[Claude Workspace] Failed to install dependencies:', error.message);
+      process.exit(1);
+    }
+  }
 
   // Check if .next directory exists, if not, build it first
   if (!fs.existsSync(nextBuildDir)) {
-    console.log('[Claude Workspace] First run detected - building production bundle...');
+    console.log('[Claude Workspace] Building production bundle...');
     console.log('[Claude Workspace] This may take a minute...');
     console.log('');
 
     const { execSync } = require('child_process');
     try {
-      // Use local next binary directly to avoid module singleton conflicts
-      // when running via npx (which fetches from registry)
       const nextBin = path.join(packageRoot, 'node_modules', '.bin', 'next');
 
-      if (!fs.existsSync(nextBin)) {
-        // Dependencies not installed, install them first
-        console.log('[Claude Workspace] Installing dependencies...');
-        let installCmd = 'npm install --production=false';
-        try {
-          execSync('which pnpm', { stdio: 'ignore' });
-          installCmd = 'pnpm install';
-        } catch {
-          // pnpm not found, use npm
-        }
-        execSync(installCmd, {
-          cwd: packageRoot,
-          stdio: 'inherit',
-          env: { ...process.env }
-        });
-      }
-
       // Run next build using local binary directly
       execSync(`"${nextBin}" build`, {
         cwd: packageRoot,
@@ -84,6 +117,8 @@ async function startServer() {
       console.error('[Claude Workspace] Please ensure all dependencies are installed');
       process.exit(1);
     }
+  } else {
+    console.log('[Claude Workspace] Using cached build from:', nextBuildDir);
   }
 
   // Try to find tsx binary in different possible locations

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-ws",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "private": false,
   "description": "A beautifully crafted workspace interface for Claude Code with real-time streaming and local SQLite database",
   "keywords": [
@@ -65,7 +65,8 @@
     "version:patch": "npm version patch --no-git-tag-version",
     "version:minor": "npm version minor --no-git-tag-version",
     "version:major": "npm version major --no-git-tag-version",
-    "publish:npm": "pnpm run build && npm publish --access public"
+    "prepublishOnly": "pnpm run build",
+    "publish:npm": "npm publish --access public"
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.5",
@@ -144,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
+  }
+}