claude-ws 0.3.100 → 0.3.101

package/README.md

@@ -1,49 +1,99 @@
 # Claude Workspace
 
+**AI-powered workspace for solo CEOs and indie builders** — manage your entire business with AI agents, not just code. Kanban board, code editor, Git integration, claw agent hub, local-first SQLite.
+
 > **DISCLAIMER:** This software is provided "AS IS" without warranty. [Read full disclaimer](./DISCLAIMER.md).
 
-**Visual workspace for Claude Code** — Kanban board, code editor, Git integration, local-first SQLite.
+![Desktop](./public/desktop-review-0.png)
+
+---
+
+## Vision
 
-![Desktop](./public/desktop-review-0.jpeg)
+Claude Workspace is evolving from a developer tool into a **full AI-powered business hub**. By integrating ClaudeWs existing multi-agents, [OpenClaw](https://openclaw.ai/) and compatible claw agents, solo founders can manage email, calendar, messaging, sales, support, and operations — all from one workspace alongside their code. See the [Project Roadmap](./docs/project-roadmap.md) for details.
 
 ---
 
 ## Features
 
+### Development
 - **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
+- **Agentic SDK** — Headless REST + SSE backend for programmatic access ([docs](./packages/agentic-sdk/README.md))
 - **Themes** — Light, Dark, VS Code variants, Dracula
 
+### Business Hub (Coming Q2 2026)
+- **Claw Agent Hub** — Adopt and manage [OpenClaw](https://openclaw.ai/) agents for business tasks
+- **Multi-Channel Inbox** — Unified messaging across WhatsApp, Slack, Discord, Teams, email
+- **Business Agent Templates** — Pre-built agents for email, calendar, social media, customer support
+- **Workflow Automation** — Visual pipelines connecting agents to automate business operations
+
 ---
 
 ## Quick Start
 
-**Prerequisites:** Node.js 20+, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
+**Prerequisites:** Node.js 20+, pnpm 9+, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
 
 ```bash
 # Option 1: npx (quick try)
 npx -y claude-ws
 
-# Option 2: Global install (recommended)
+# Option 2: Global install
 npm install -g claude-ws
 claude-ws
 
 # Option 3: From source
 git clone https://github.com/Claude-Workspace/claude-ws.git
 cd claude-ws
-pnpm install && pnpm run dev
-or
-pnpm install && pmpm run build && pnpm start
+pnpm install && pnpm dev
 ```
 
 Open http://localhost:8556
 
 ---
 
+## Project Structure
+
+```
+claude-ws/
+├── src/                        # Next.js app (frontend + API routes)
+├── server.ts                   # Custom server entry point
+├── packages/
+│   └── agentic-sdk/            # Headless Fastify backend (REST + SSE)
+├── public/                     # Static assets, swagger docs
+├── drizzle/                    # Database migrations
+├── locales/                    # i18n translations
+└── scripts/                    # Build and maintenance scripts
+```
+
+### Packages
+
+| Package | Description |
+|---------|-------------|
+| **[agentic-sdk](./packages/agentic-sdk/)** | Standalone Fastify server implementing the full claude-ws API. No frontend, no Socket.io — pure REST + SSE. Use it for headless automation, CI/CD pipelines, or custom integrations. |
+
+---
+
+## Running the Agentic SDK
+
+The agentic-sdk is a headless backend that exposes the same API as the main claude-ws server but without the UI. Useful for programmatic task execution, automation, and integration with external tools.
+
+```bash
+# Development (with file watching)
+pnpm agentic-sdk:dev
+
+# Production
+pnpm agentic-sdk:start
+```
+
+Server starts at http://localhost:3100. See [agentic-sdk README](./packages/agentic-sdk/README.md) for full API documentation.
+
+---
+
 ## API Documentation
 
 See [Swagger API Docs](README-docs-swagger.md)
@@ -52,24 +102,37 @@ See [Swagger API Docs](README-docs-swagger.md)
 
 ## Configuration
 
-Create `.env` file (or use `~/.claude-ws/.env`):
+Create `.env` file at the project root:
 
 ```bash
-# Optional: API authentication for remote access
+# Server
+PORT=8556
 API_ACCESS_KEY=your-secret-key
 
-# Optional: Custom Claude CLI path
-CLAUDE_PATH=/path/to/claude
+# Anthropic API (or custom proxy)
+ANTHROPIC_BASE_URL=https://api.anthropic.com
+ANTHROPIC_AUTH_TOKEN=your-token
+ANTHROPIC_MODEL=claude-sonnet-4-20250514
+
+# Model tier overrides (optional)
+ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6
+ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
+ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001
 ```
 
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `PORT` | Server port | `8556` |
 | `API_ACCESS_KEY` | API authentication key | (empty) |
-| `LOG_LEVEL` | Logging level: `debug`, `info`, `warn`, `error`, `silent` | `debug` (dev), `warn` (prod) |
-| `ANTHROPIC_API_RETRY_TIMES` | Number of retry attempts for failed Anthropic API requests (5xx errors or network failures) | `3` |
-| `ANTHROPIC_API_RETRY_DELAY_MS` | Delay between retry attempts in milliseconds | `10000` |
-
+| `ANTHROPIC_BASE_URL` | Anthropic API base URL (or custom endpoint) | `https://api.anthropic.com` |
+| `ANTHROPIC_AUTH_TOKEN` | Auth token for the Anthropic API | — |
+| `ANTHROPIC_MODEL` | Default model | — |
+| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Model for opus tier | Falls back to `ANTHROPIC_MODEL` |
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Model for sonnet tier | Falls back to `ANTHROPIC_MODEL` |
+| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Model for haiku tier | Falls back to `ANTHROPIC_MODEL` |
+| `LOG_LEVEL` | Logging level | `debug` (dev), `warn` (prod) |
+| `ANTHROPIC_API_RETRY_TIMES` | Retry attempts for failed API requests | `3` |
+| `ANTHROPIC_API_RETRY_DELAY_MS` | Delay between retries (ms) | `10000` |
 
 ---
 
@@ -81,10 +144,30 @@ For secure remote access, see [Cloudflare Tunnel Setup](./docs/cloudflare-tunnel
 
 ## Tech Stack
 
-Next.js 16, React 19, SQLite + Drizzle ORM, Socket.io, Tailwind CSS 4, Radix UI, Zustand
+Next.js 16, React 19, Fastify 5, SQLite + Drizzle ORM, Socket.io, Claude Agent SDK, Tailwind CSS 4, Radix UI, Zustand, Pino
+
+---
+
+## Documentation
+
+- [Project Overview & PDR](./docs/project-overview-pdr.md) — Features, tech stack, requirements
+- [Project Roadmap](./docs/project-roadmap.md) — Feature timeline, claw agent integration plans
+- [System Architecture](./docs/system-architecture.md) — Component design, API structure
+- [Code Standards](./docs/code-standards.md) — Development conventions and patterns
+- [Cloudflare Tunnel Setup](./docs/cloudflare-tunnel.md) — Remote access configuration
 
 ---
 
 ## License
 
 MIT
+
+---
+
+## Screenshots
+
+![Desktop](./public/desktop-review-0.png)
+![Desktop](./public/desktop-review-1.png)
+![Desktop](./public/desktop-review-3.png)
+![Desktop](./public/desktop-review-4.png)
+![Mobile](./public/mobile-review-0.png)

package/locales/de.json

@@ -111,7 +111,10 @@
     "waitFileUpload": "Bitte warten Sie, bis der Datei-Upload abgeschlossen ist",
     "failedToCreate": "Aufgabe konnte nicht erstellt werden",
     "dragToReorder": "Zum Neuanordnen ziehen",
-    "deleteTask": "Aufgabe löschen"
+    "deleteTask": "Aufgabe löschen",
+    "moveTo": "Verschieben nach",
+    "duplicate": "Duplizieren",
+    "delete": "Löschen"
   },
   "task": {
     "title": "Titel",
@@ -344,6 +347,11 @@
     "showAllBranches": "Alle Branches anzeigen",
     "showCurrentBranchOnly": "Nur aktuellen Branch anzeigen",
     "fetch": "Abrufen",
+    "fetching": "Abrufen...",
+    "pull": "Pull",
+    "pulling": "Pulling...",
+    "push": "Push",
+    "pushing": "Pushing...",
     "searchBranches": "Branches suchen...",
     "copyFullHash": "Vollständigen Hash kopieren",
     "checkoutCommit": "Diesen Commit auschecken (abgetrennter HEAD-Zustand)",

package/locales/en.json

@@ -111,7 +111,10 @@
     "waitFileUpload": "Please wait for files to finish uploading",
     "failedToCreate": "Failed to create task",
     "dragToReorder": "Drag to reorder",
-    "deleteTask": "Delete task"
+    "deleteTask": "Delete task",
+    "moveTo": "Move to",
+    "duplicate": "Duplicate",
+    "delete": "Delete"
   },
   "task": {
     "title": "Title",
@@ -344,6 +347,11 @@
     "showAllBranches": "Show all branches",
     "showCurrentBranchOnly": "Show current branch only",
     "fetch": "Fetch",
+    "fetching": "Fetching...",
+    "pull": "Pull",
+    "pulling": "Pulling...",
+    "push": "Push",
+    "pushing": "Pushing...",
     "searchBranches": "Search branches...",
     "copyFullHash": "Copy full hash",
     "checkoutCommit": "Checkout this commit (detached HEAD state)",
@@ -595,6 +603,9 @@
     "rewoundToCheckpoint": "Rewound conversation & files to checkpoint",
     "rewoundConversationOnly": "Rewound conversation only",
     "rewoundConversation": "Rewound conversation to checkpoint",
+    "forkedToCheckpoint": "Forked conversation & files from checkpoint",
+    "forkedConversationOnly": "Forked conversation only",
+    "forkedConversation": "Forked conversation from checkpoint",
     "waitForUpload": "Please wait for files to finish uploading"
   },
   "agentProvider": {

package/locales/es.json

@@ -111,7 +111,10 @@
     "waitFileUpload": "Por favor espere a que los archivos terminen de subir",
     "failedToCreate": "Fallo al crear tarea",
     "dragToReorder": "Arrastrar para reordenar",
-    "deleteTask": "Eliminar tarea"
+    "deleteTask": "Eliminar tarea",
+    "moveTo": "Mover a",
+    "duplicate": "Duplicar",
+    "delete": "Eliminar"
   },
   "task": {
     "title": "Título",
@@ -344,6 +347,11 @@
     "showAllBranches": "Mostrar todas las ramas",
     "showCurrentBranchOnly": "Mostrar solo la rama actual",
     "fetch": "Obtener",
+    "fetching": "Obteniendo...",
+    "pull": "Pull",
+    "pulling": "Pulling...",
+    "push": "Push",
+    "pushing": "Pushing...",
     "searchBranches": "Buscar ramas...",
     "copyFullHash": "Copiar hash completo",
     "checkoutCommit": "Cambiar a este commit (estado HEAD desconectado)",

package/locales/fr.json

@@ -111,7 +111,10 @@
     "waitFileUpload": "Veuillez attendre que les fichiers finissent de télécharger",
     "failedToCreate": "Échec de la création de la tâche",
     "dragToReorder": "Glisser pour réorganiser",
-    "deleteTask": "Supprimer la tâche"
+    "deleteTask": "Supprimer la tâche",
+    "moveTo": "Déplacer vers",
+    "duplicate": "Dupliquer",
+    "delete": "Supprimer"
   },
   "task": {
     "title": "Titre",
@@ -344,6 +347,11 @@
     "showAllBranches": "Afficher toutes les branches",
     "showCurrentBranchOnly": "Afficher uniquement la branche courante",
     "fetch": "Fetch",
+    "fetching": "Récupération...",
+    "pull": "Pull",
+    "pulling": "Pulling...",
+    "push": "Push",
+    "pushing": "Pushing...",
     "searchBranches": "Rechercher des branches...",
     "copyFullHash": "Copier le hash complet",
     "checkoutCommit": "Extraire ce commit (état HEAD détaché)",

package/locales/ja.json

@@ -111,7 +111,10 @@
     "waitFileUpload": "ファイルのアップロードが完了するまでお待ちください",
     "failedToCreate": "タスクの作成に失敗しました",
     "dragToReorder": "ドラッグして並べ替え",
-    "deleteTask": "タスクを削除"
+    "deleteTask": "タスクを削除",
+    "moveTo": "移動先",
+    "duplicate": "複製",
+    "delete": "削除"
   },
   "task": {
     "title": "タイトル",
@@ -344,6 +347,11 @@
     "showAllBranches": "すべてのブランチを表示",
     "showCurrentBranchOnly": "現在のブランチのみ表示",
     "fetch": "フェッチ",
+    "fetching": "フェッチ中...",
+    "pull": "Pull",
+    "pulling": "Pull中...",
+    "push": "Push",
+    "pushing": "Push中...",
     "searchBranches": "ブランチを検索...",
     "copyFullHash": "完全なハッシュをコピー",
     "checkoutCommit": "このコミットをチェックアウト（detached HEAD 状態）",

package/locales/ko.json

@@ -111,7 +111,10 @@
     "waitFileUpload": "파일 업로드가 완료될 때까지 기다려주세요",
     "failedToCreate": "작업 만들기 실패",
     "dragToReorder": "드래그하여 재정렬",
-    "deleteTask": "작업 삭제"
+    "deleteTask": "작업 삭제",
+    "moveTo": "이동",
+    "duplicate": "복제",
+    "delete": "삭제"
   },
   "task": {
     "title": "제목",
@@ -344,6 +347,11 @@
     "showAllBranches": "모든 브랜치 표시",
     "showCurrentBranchOnly": "현재 브랜치만 표시",
     "fetch": "가져오기",
+    "fetching": "가져오는 중...",
+    "pull": "Pull",
+    "pulling": "Pull 중...",
+    "push": "Push",
+    "pushing": "Push 중...",
     "searchBranches": "브랜치 검색...",
     "copyFullHash": "전체 해시 복사",
     "checkoutCommit": "이 커밋 체크아웃 (분리된 HEAD 상태)",

package/locales/vi.json

@@ -111,7 +111,10 @@
     "waitFileUpload": "Vui lòng đợi tập tin tải lên xong",
     "failedToCreate": "Không thể tạo nhiệm vụ",
     "dragToReorder": "Kéo để sắp xếp lại",
-    "deleteTask": "Xóa nhiệm vụ"
+    "deleteTask": "Xóa nhiệm vụ",
+    "moveTo": "Di chuyển đến",
+    "duplicate": "Nhân bản",
+    "delete": "Xóa"
   },
   "task": {
     "title": "Tiêu đề",
@@ -344,6 +347,11 @@
     "showAllBranches": "Hiển thị tất cả nhánh",
     "showCurrentBranchOnly": "Chỉ hiển thị nhánh hiện tại",
     "fetch": "Tải về",
+    "fetching": "Đang fetch...",
+    "pull": "Pull",
+    "pulling": "Đang pull...",
+    "push": "Push",
+    "pushing": "Đang push...",
     "searchBranches": "Tìm kiếm nhánh...",
     "copyFullHash": "Sao chép mã hash đầy đủ",
     "checkoutCommit": "Checkout commit này (trạng thái HEAD tách rời)",

package/locales/zh.json

@@ -111,7 +111,10 @@
     "waitFileUpload": "请等待文件上传完成",
     "failedToCreate": "创建任务失败",
     "dragToReorder": "拖动以重新排序",
-    "deleteTask": "删除任务"
+    "deleteTask": "删除任务",
+    "moveTo": "移动到",
+    "duplicate": "复制",
+    "delete": "删除"
   },
   "task": {
     "title": "标题",
@@ -344,6 +347,11 @@
     "showAllBranches": "显示所有分支",
     "showCurrentBranchOnly": "仅显示当前分支",
     "fetch": "拉取",
+    "fetching": "正在拉取...",
+    "pull": "Pull",
+    "pulling": "正在Pull...",
+    "push": "Push",
+    "pushing": "正在Push...",
     "searchBranches": "搜索分支...",
     "copyFullHash": "复制完整哈希值",
     "checkoutCommit": "检出此提交（分离 HEAD 状态）",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-ws",
-  "version": "0.3.100",
+  "version": "0.3.101",
   "private": false,
   "description": "A beautifully crafted workspace interface for Claude Code with real-time streaming and local SQLite database",
   "keywords": [
@@ -62,11 +62,13 @@
   },
   "scripts": {
     "postinstall": "node -e \"try{require('fs').chmodSync(require('path').join('node_modules','@homebridge','node-pty-prebuilt-multiarch','prebuilds',process.platform+'-'+process.arch,'spawn-helper'),0o755)}catch{}\"",
-    "dev": "tsx server.ts",
+    "dev": "cross-env CLAUDECODE= tsx server.ts",
     "build": "cross-env NODE_ENV=production next build",
-    "start": "cross-env NODE_ENV=production tsx server.ts",
+    "start": "cross-env NODE_ENV=production CLAUDECODE= tsx server.ts",
     "db:generate": "drizzle-kit generate",
-    "db:fix": "tsx scripts/db-fix-columns.ts"
+    "db:fix": "tsx scripts/db-fix-columns.ts",
+    "agentic-sdk:dev": "tsx watch packages/agentic-sdk/bin/server-entrypoint.ts",
+    "agentic-sdk:start": "cross-env NODE_ENV=production tsx packages/agentic-sdk/bin/server-entrypoint.ts"
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.42",
@@ -91,6 +93,9 @@
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
+    "@fastify/cors": "^11.2.0",
+    "@fastify/multipart": "^9.4.0",
+    "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
     "@radix-ui/react-checkbox": "^1.3.3",
     "@radix-ui/react-context-menu": "^2.2.16",
     "@radix-ui/react-dialog": "^1.1.15",
@@ -108,6 +113,7 @@
     "@types/adm-zip": "^0.5.7",
     "@types/better-sqlite3": "^7.6.13",
     "@types/compression": "^1.8.1",
+    "@types/dompurify": "^3.2.0",
     "@types/node": "^20.19.33",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
@@ -116,6 +122,7 @@
     "@xterm/addon-web-links": "^0.12.0",
     "@xterm/xterm": "^6.0.0",
     "adm-zip": "^0.5.16",
+    "beautiful-mermaid": "^1.1.3",
     "better-sqlite3": "^12.6.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -125,11 +132,14 @@
     "ctunnel": "^1.0.3",
     "date-fns": "^4.1.0",
     "diff": "^8.0.3",
+    "dompurify": "^3.3.3",
     "dotenv": "^17.2.4",
     "drizzle-kit": "^0.31.9",
     "drizzle-orm": "^0.45.1",
     "eslint": "^9.39.2",
     "eslint-config-next": "^16.1.6",
+    "fastify": "^5.8.2",
+    "fastify-plugin": "^5.1.0",
     "highlight.js": "^11.11.1",
     "js-yaml": "^4.1.1",
     "lowlight": "^3.3.0",
@@ -138,7 +148,6 @@
     "next": "^16.1.6",
     "next-intl": "^4.8.2",
     "next-themes": "^0.4.6",
-    "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
     "react": "19.2.3",