Visual workspace for Claude Code with Kanban board, code editor, and Git integration.
Local-first SQLite database. Real-time streaming. Plugin system for custom agents and skills.
| 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 |
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
Prerequisites: Node.js 20+, pnpm 9+, Claude Code CLI
npx -y claude-wsThe -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
npm install -g claude-ws
claude-wsGlobal installation avoids npx prompts and rebuilding on every run.
git clone https://github.com/Claude-Workspace/claude-ws.git
cd claude-ws
pnpm install
pnpm db:migrate
pnpm devclaude-ws --versionnpm update -g claude-wsnpm install -g claude-ws@latest- 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
| 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 |
MIT