claude-ws 0.1.24 → 0.1.26

package/README.md

@@ -1,321 +1,88 @@
 # Claude Workspace
 
-> ⚠️ **DISCLAIMER:** This software is provided "AS IS" without warranty. The owners and contributors accept **no liability** for any damages or claims arising from its use. [Read full disclaimer](./DISCLAIMER.md).
+> **DISCLAIMER:** This software is provided "AS IS" without warranty. [Read full disclaimer](./DISCLAIMER.md).
 
-**Visual workspace for Claude Code with Kanban board, code editor, and Git integration.**
+**Visual workspace for Claude Code** — Kanban board, code editor, Git integration, local-first SQLite.
 
-Local-first SQLite database. Real-time streaming. Plugin system for custom agents and skills.
-
----
-
-## Why Claude Workspace?
-
-| 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 |
+![Desktop](./public/desktop-review-0.jpeg)
 
 ---
 
 ## Features
 
-**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
+- **Kanban Board** — Drag-and-drop task management with full conversation history
+- **Real-time Streaming** — Live Claude responses via Socket.io
+- **Checkpoints** — Save and rewind to any conversation state
+- **Code Editor** — Tabbed CodeMirror with syntax highlighting and AI suggestions
+- **Git Integration** — Status, stage, commit, diff, visual graph
+- **Agent Factory** — Plugin system for custom skills, commands, agents
+- **Themes** — Light, Dark, VS Code variants, Dracula
 
 ---
 
 ## Quick Start
 
-### Option 1: Run with npx
-
-**Prerequisites:** Node.js 20+, pnpm 9+, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
+**Prerequisites:** Node.js 20+, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
 
 ```bash
+# Option 1: npx (quick try)
 npx -y claude-ws
-```
 
-The `-y` flag skips the "Ok to proceed?" prompt.
-
-The first run will:
-- Auto-create SQLite database in `~/.claude-ws/`
-- Install dependencies and build automatically
-- Start the server on http://localhost:8556
-
-### Option 2: Install globally (Recommended)
-
-```bash
+# Option 2: Global install (recommended)
 npm install -g claude-ws
 claude-ws
-```
-
-Global installation avoids npx prompts and rebuilding on every run.
 
-### Option 3: Development from source
-
-```bash
+# Option 3: From source
 git clone https://github.com/Claude-Workspace/claude-ws.git
 cd claude-ws
-pnpm install
-pnpm db:migrate
-pnpm dev
+pnpm install && pnpm dev
 ```
 
-Open [http://localhost:8556](http://localhost:8556)
+Open http://localhost:8556
 
 ---
 
 ## Configuration
 
-### API Authentication (Optional)
-
-For secure deployments, you can enable API authentication by setting an `API_ACCESS_KEY`:
-
-1. Create a `.env` file in your project directory (or use the global one in `~/.claude-ws/.env`)
-2. Add your API access key:
+Create `.env` file (or use `~/.claude-ws/.env`):
 
 ```bash
-# .env
-API_ACCESS_KEY=your-secret-key-here
-```
-
-3. All API requests must include the key in the `x-api-key` header:
+# Optional: API authentication for remote access
+API_ACCESS_KEY=your-secret-key
 
-```bash
-curl -H "x-api-key: your-secret-key-here" http://localhost:8556/api/conversations
-```
-
-**Note:** Leave `API_ACCESS_KEY` empty to disable authentication (default for local development).
-
-### Claude Code CLI Path
-
-Claude Workspace requires the Claude Code CLI to be installed. Set the `CLAUDE_PATH` environment variable to point to your Claude executable:
-
-**Linux/Ubuntu:**
-```bash
-CLAUDE_PATH=/home/$(whoami)/.local/bin/claude
-```
-
-**macOS (Homebrew):**
-```bash
-CLAUDE_PATH=/opt/homebrew/bin/claude
+# Optional: Custom Claude CLI path
+CLAUDE_PATH=/path/to/claude
 ```
 
-**Windows:**
-```bash
-CLAUDE_PATH=%USERPROFILE%\.local\bin\claude.exe
-```
-
-Add this to your `.env` file in the project directory, or the global `.env` at `~/.claude-ws/.env`.
-
-### Environment Variables
-
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `CLAUDE_PATH` | Path to Claude Code CLI executable | Auto-detected |
-| `PORT` | Server port | `3000` |
-| `NODE_ENV` | Environment mode | `development` |
-| `API_ACCESS_KEY` | API authentication key | (empty, no auth) |
-| `DATABASE_URL` | SQLite database path | `./data.db` |
-| `AGENT_FACTORY_DIR` | Agent Factory plugins directory | `~/.claude/agentfactory` |
+| `PORT` | Server port | `8556` |
+| `API_ACCESS_KEY` | API authentication key | (empty) |
+| `CLAUDE_PATH` | Claude CLI path | Auto-detected |
 
 ---
 
-## Work Everywhere with Cloudflare Tunnel
-
-Access Claude Workspace securely from anywhere using Cloudflare Tunnel + Access.
-
-### 1. Install cloudflared
-
-```bash
-# macOS
-brew install cloudflared
-
-# Linux
-curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o cloudflared
-chmod +x cloudflared && sudo mv cloudflared /usr/local/bin/
-
-# Windows
-winget install Cloudflare.cloudflared
-```
-
-### 2. Authenticate with Cloudflare
+## Production (PM2)
 
 ```bash
-cloudflared tunnel login
-```
-
-### 3. Create Tunnel
-
-```bash
-cloudflared tunnel create claude-workspace
-```
-
-### 4. Configure Tunnel
-
-Create `~/.cloudflared/config.yml`:
-
-```yaml
-tunnel: claude-workspace
-credentials-file: ~/.cloudflared/<TUNNEL_ID>.json
-
-ingress:
-  - hostname: claude-ws.yourdomain.com
-    service: http://localhost:8556
-  - service: http_status:404
-```
-
-### 5. Add DNS Record
-
-```bash
-cloudflared tunnel route dns claude-workspace claude-ws.yourdomain.com
-```
-
-### 6. Run Tunnel
-
-```bash
-# Foreground
-cloudflared tunnel run claude-workspace
-
-# Or as service (recommended)
-sudo cloudflared service install
-sudo systemctl enable cloudflared
-sudo systemctl start cloudflared
+npm install -g pm2
+pnpm pm2:start    # Start server (auto-builds)
+pnpm pm2:logs     # View logs
+pnpm pm2:restart  # Restart
+pnpm pm2:stop     # Stop
 ```
 
-### 7. Setup Cloudflare Access (Authentication)
-
-1. Go to [Cloudflare Zero Trust Dashboard](https://one.dash.cloudflare.com/)
-2. Navigate to **Access** → **Applications** → **Add an application**
-3. Select **Self-hosted**
-4. Configure:
-   - **Application name**: Claude Workspace
-   - **Session duration**: 24 hours (or your preference)
-   - **Application domain**: `claude-ws.yourdomain.com`
-5. Add **Access Policy**:
-   - **Policy name**: Allowed Users
-   - **Action**: Allow
-   - **Include**: Emails ending in `@yourdomain.com` or specific email addresses
-6. Save and deploy
-
-Now access `https://claude-ws.yourdomain.com` from anywhere with Cloudflare authentication.
-
 ---
 
-## Updating
-
-### Check current version
-```bash
-claude-ws --version
-```
-
-### Update to latest version
-```bash
-npm update -g claude-ws
-```
+## Remote Access
 
-### Force reinstall
-```bash
-npm install -g claude-ws@latest
-```
+For secure remote access, see [Cloudflare Tunnel Setup](./docs/cloudflare-tunnel.md).
 
 ---
 
 ## Tech Stack
 
-- **Framework**: Next.js 16 + React 19
-- **Database**: SQLite + Drizzle ORM
-- **Real-time**: Socket.io
-- **Styling**: Tailwind CSS 4
-- **UI**: Radix UI primitives
-- **State**: Zustand
-- **Drag & Drop**: dnd-kit
-
----
-
-## Scripts
-
-| Command | Description |
-|---------|-------------|
-| `pnpm dev` | Start development server |
-| `pnpm build` | Build for production |
-| `pnpm start` | Start production server |
-| `pnpm lint` | Run ESLint |
-| `pnpm db:migrate` | Run database migrations |
-| `pnpm pm2:start` | Start with PM2 process manager |
-| `pnpm pm2:stop` | Stop PM2 process |
-| `pnpm pm2:restart` | Restart PM2 process |
-| `pnpm pm2:logs` | View PM2 logs |
-| `pnpm pm2:monit` | Monitor PM2 process |
-
-### Running with PM2
-
-For production deployments with auto-restart and process management:
-
-```bash
-# Install PM2 globally (if not already installed)
-npm install -g pm2
-
-# Start the server
-pnpm pm2:start
-
-# View logs
-pnpm pm2:logs
-
-# Monitor process
-pnpm pm2:monit
-
-# Restart
-pnpm pm2:restart
-
-# Stop
-pnpm pm2:stop
-```
-
-PM2 Features:
-- Auto-restart on crash (max 10 attempts)
-- Memory limit monitoring (500MB)
-- Log rotation and management
-- Process status tracking
+Next.js 16, React 19, SQLite + Drizzle ORM, Socket.io, Tailwind CSS 4, Radix UI, Zustand
 
 ---
 

package/drizzle/0000_low_gressill.sql

@@ -0,0 +1,164 @@
+CREATE TABLE `agent_factory_plugins` (
+	`id` text PRIMARY KEY NOT NULL,
+	`type` text NOT NULL,
+	`name` text NOT NULL,
+	`description` text,
+	`source_path` text,
+	`storage_type` text DEFAULT 'local' NOT NULL,
+	`agent_set_path` text,
+	`metadata` text,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE `attempt_files` (
+	`id` text PRIMARY KEY NOT NULL,
+	`attempt_id` text NOT NULL,
+	`filename` text NOT NULL,
+	`original_name` text NOT NULL,
+	`mime_type` text NOT NULL,
+	`size` integer NOT NULL,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`attempt_id`) REFERENCES `attempts`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `idx_attempt_files_attempt` ON `attempt_files` (`attempt_id`);--> statement-breakpoint
+CREATE TABLE `attempt_logs` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`attempt_id` text NOT NULL,
+	`type` text NOT NULL,
+	`content` text NOT NULL,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`attempt_id`) REFERENCES `attempts`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `idx_logs_attempt` ON `attempt_logs` (`attempt_id`,`created_at`);--> statement-breakpoint
+CREATE TABLE `attempts` (
+	`id` text PRIMARY KEY NOT NULL,
+	`task_id` text NOT NULL,
+	`prompt` text NOT NULL,
+	`display_prompt` text,
+	`status` text DEFAULT 'running' NOT NULL,
+	`session_id` text,
+	`branch` text,
+	`diff_additions` integer DEFAULT 0 NOT NULL,
+	`diff_deletions` integer DEFAULT 0 NOT NULL,
+	`total_tokens` integer DEFAULT 0 NOT NULL,
+	`input_tokens` integer DEFAULT 0 NOT NULL,
+	`output_tokens` integer DEFAULT 0 NOT NULL,
+	`cache_creation_tokens` integer DEFAULT 0 NOT NULL,
+	`cache_read_tokens` integer DEFAULT 0 NOT NULL,
+	`total_cost_usd` integer DEFAULT 0 NOT NULL,
+	`num_turns` integer DEFAULT 0 NOT NULL,
+	`duration_ms` integer DEFAULT 0 NOT NULL,
+	`created_at` integer NOT NULL,
+	`completed_at` integer,
+	FOREIGN KEY (`task_id`) REFERENCES `tasks`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `idx_attempts_task` ON `attempts` (`task_id`,`created_at`);--> statement-breakpoint
+CREATE TABLE `checkpoints` (
+	`id` text PRIMARY KEY NOT NULL,
+	`task_id` text NOT NULL,
+	`attempt_id` text NOT NULL,
+	`session_id` text NOT NULL,
+	`git_commit_hash` text,
+	`message_count` integer NOT NULL,
+	`summary` text,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`task_id`) REFERENCES `tasks`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`attempt_id`) REFERENCES `attempts`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `idx_checkpoints_task` ON `checkpoints` (`task_id`,`created_at`);--> statement-breakpoint
+CREATE TABLE `plugin_dependencies` (
+	`id` text PRIMARY KEY NOT NULL,
+	`plugin_id` text NOT NULL,
+	`dependency_type` text NOT NULL,
+	`spec` text NOT NULL,
+	`plugin_dependency_id` text,
+	`installed` integer DEFAULT false NOT NULL,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`plugin_id`) REFERENCES `agent_factory_plugins`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`plugin_dependency_id`) REFERENCES `agent_factory_plugins`(`id`) ON UPDATE no action ON DELETE set null
+);
+--> statement-breakpoint
+CREATE INDEX `idx_plugin_deps` ON `plugin_dependencies` (`plugin_id`);--> statement-breakpoint
+CREATE INDEX `idx_plugin_depends_on` ON `plugin_dependencies` (`plugin_dependency_id`);--> statement-breakpoint
+CREATE TABLE `plugin_dependency_cache` (
+	`id` text PRIMARY KEY NOT NULL,
+	`plugin_id` text,
+	`source_path` text,
+	`source_hash` text,
+	`type` text NOT NULL,
+	`library_deps` text,
+	`plugin_deps` text,
+	`install_script_npm` text,
+	`install_script_pnpm` text,
+	`install_script_yarn` text,
+	`install_script_pip` text,
+	`install_script_poetry` text,
+	`install_script_cargo` text,
+	`install_script_go` text,
+	`dockerfile` text,
+	`depth` integer DEFAULT 0 NOT NULL,
+	`has_cycles` integer DEFAULT false NOT NULL,
+	`resolved_at` integer NOT NULL,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`plugin_id`) REFERENCES `agent_factory_plugins`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `idx_cache_plugin` ON `plugin_dependency_cache` (`plugin_id`);--> statement-breakpoint
+CREATE INDEX `idx_cache_source` ON `plugin_dependency_cache` (`source_path`);--> statement-breakpoint
+CREATE TABLE `project_plugins` (
+	`id` text PRIMARY KEY NOT NULL,
+	`project_id` text NOT NULL,
+	`plugin_id` text NOT NULL,
+	`enabled` integer DEFAULT true NOT NULL,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`project_id`) REFERENCES `projects`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`plugin_id`) REFERENCES `agent_factory_plugins`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `idx_project_plugins` ON `project_plugins` (`project_id`,`plugin_id`);--> statement-breakpoint
+CREATE TABLE `projects` (
+	`id` text PRIMARY KEY NOT NULL,
+	`name` text NOT NULL,
+	`path` text NOT NULL,
+	`created_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `projects_path_unique` ON `projects` (`path`);--> statement-breakpoint
+CREATE TABLE `shells` (
+	`id` text PRIMARY KEY NOT NULL,
+	`project_id` text NOT NULL,
+	`attempt_id` text,
+	`command` text NOT NULL,
+	`cwd` text NOT NULL,
+	`pid` integer,
+	`status` text DEFAULT 'running' NOT NULL,
+	`exit_code` integer,
+	`exit_signal` text,
+	`created_at` integer NOT NULL,
+	`stopped_at` integer,
+	FOREIGN KEY (`project_id`) REFERENCES `projects`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`attempt_id`) REFERENCES `attempts`(`id`) ON UPDATE no action ON DELETE set null
+);
+--> statement-breakpoint
+CREATE INDEX `idx_shells_project` ON `shells` (`project_id`,`status`);--> statement-breakpoint
+CREATE TABLE `tasks` (
+	`id` text PRIMARY KEY NOT NULL,
+	`project_id` text NOT NULL,
+	`title` text NOT NULL,
+	`description` text,
+	`status` text DEFAULT 'todo' NOT NULL,
+	`position` integer NOT NULL,
+	`chat_init` integer DEFAULT false NOT NULL,
+	`rewind_session_id` text,
+	`rewind_message_uuid` text,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	FOREIGN KEY (`project_id`) REFERENCES `projects`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `idx_tasks_project` ON `tasks` (`project_id`,`status`,`position`);

package/drizzle/0001_calm_thunderbolt_ross.sql

@@ -0,0 +1,33 @@
+PRAGMA foreign_keys=OFF;--> statement-breakpoint
+CREATE TABLE `__new_attempts` (
+	`id` text PRIMARY KEY NOT NULL,
+	`task_id` text NOT NULL,
+	`prompt` text NOT NULL,
+	`display_prompt` text,
+	`status` text DEFAULT 'running' NOT NULL,
+	`session_id` text,
+	`branch` text,
+	`diff_additions` integer DEFAULT 0 NOT NULL,
+	`diff_deletions` integer DEFAULT 0 NOT NULL,
+	`total_tokens` integer DEFAULT 0 NOT NULL,
+	`input_tokens` integer DEFAULT 0 NOT NULL,
+	`output_tokens` integer DEFAULT 0 NOT NULL,
+	`cache_creation_tokens` integer DEFAULT 0 NOT NULL,
+	`cache_read_tokens` integer DEFAULT 0 NOT NULL,
+	`total_cost_usd` text DEFAULT '0' NOT NULL,
+	`num_turns` integer DEFAULT 0 NOT NULL,
+	`duration_ms` integer DEFAULT 0 NOT NULL,
+	`context_used` integer DEFAULT 0 NOT NULL,
+	`context_limit` integer DEFAULT 200000 NOT NULL,
+	`context_percentage` integer DEFAULT 0 NOT NULL,
+	`baseline_context` integer DEFAULT 0 NOT NULL,
+	`created_at` integer NOT NULL,
+	`completed_at` integer,
+	FOREIGN KEY (`task_id`) REFERENCES `tasks`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+INSERT INTO `__new_attempts`("id", "task_id", "prompt", "display_prompt", "status", "session_id", "branch", "diff_additions", "diff_deletions", "total_tokens", "input_tokens", "output_tokens", "cache_creation_tokens", "cache_read_tokens", "total_cost_usd", "num_turns", "duration_ms", "context_used", "context_limit", "context_percentage", "baseline_context", "created_at", "completed_at") SELECT "id", "task_id", "prompt", "display_prompt", "status", "session_id", "branch", "diff_additions", "diff_deletions", "total_tokens", "input_tokens", "output_tokens", "cache_creation_tokens", "cache_read_tokens", "total_cost_usd", "num_turns", "duration_ms", "context_used", "context_limit", "context_percentage", "baseline_context", "created_at", "completed_at" FROM `attempts`;--> statement-breakpoint
+DROP TABLE `attempts`;--> statement-breakpoint
+ALTER TABLE `__new_attempts` RENAME TO `attempts`;--> statement-breakpoint
+PRAGMA foreign_keys=ON;--> statement-breakpoint
+CREATE INDEX `idx_attempts_task` ON `attempts` (`task_id`,`created_at`);