Claude Code Crew

Claude Code Crew

A web-based interface for managing multiple Claude Code sessions across Git worktrees.

Demo

https://github.com/user-attachments/assets/a422e29d-eb0e-4cf2-bace-7f5e50f69cb5

Features

- 🖥️ Browser-based Terminal: Full terminal emulation using xterm.js
- 🔄 Real-time Session Management: Monitor session states (busy/waiting/idle)
- 🌳 Git Worktree Operations: Create, delete, and merge worktrees
- 🔌 WebSocket Communication: Real-time updates and terminal streaming
- 🎨 Modern UI: Built with React and Material-UI
- 📱 Single-port Architecture: Everything runs on one port for easy deployment

Prerequisites

- Claude Code CLI must be installed and available in your PATH
- Node.js 18+
- Git repository (the tool manages Git worktrees)

Installation

Usage

Navigate to any Git repository and run:

The web interface will be available at http://localhost:3001

Available Features:
- View Worktrees: See all git worktrees in the sidebar
- Create Sessions: Click on any worktree to start a Claude Code session
- Monitor Status: Real-time session state indicators (busy/waiting/idle)
- Terminal History: Switch between sessions and see previous output
- Manage Worktrees: Create, delete, or merge worktrees from the UI

Configuration

Environment Variables

- PORT: Server port (default: 3001)
- WORK_DIR: Working directory (default: current directory)
- CC_CLAUDE_ARGS: Additional arguments for Claude Code sessions

Example with custom port:

Architecture

Backend (Node.js + Express + Socket.io)
- REST API for worktree operations
- WebSocket server for terminal sessions
- PTY management using node-pty
- Session state detection and history preservation

Frontend (React + TypeScript + Material-UI)
- Terminal emulation with xterm.js
- Real-time session status updates
-…