DISCLAIMER: This software is provided "AS IS" without warranty. Read full disclaimer.
Visual workspace for Claude Code — Kanban board, code editor, Git integration, local-first SQLite.
- 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
Prerequisites: Node.js 20+, Claude Code CLI
# Option 1: npx (quick try)
npx -y claude-ws
# Option 2: Global install (recommended)
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 startSee Swagger API Docs
Create .env file (or use ~/.claude-ws/.env):
# Optional: API authentication for remote access
API_ACCESS_KEY=your-secret-key
# Optional: Custom Claude CLI path
CLAUDE_PATH=/path/to/claude| 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 |
For secure remote access, see Cloudflare Tunnel Setup.
Next.js 16, React 19, SQLite + Drizzle ORM, Socket.io, Tailwind CSS 4, Radix UI, Zustand
MIT