Cc Chat Kit

CC Chat Kit

**⚠️ DISCLAIMER: This is an unofficial, community project. It is not affiliated with, endorsed by, or supported by Anthropic. Use at your own risk.**

Why CC Chat Kit?

**You love Claude Code. You want to use it from anywhere.**

Claude Code is powerful, but it's tied to your terminal. CC Chat Kit lets you build a web interface so you can chat with Claude from your phone, tablet, or any browser—while Claude Code runs on your home machine or a cloud VM.

**Common setups:**

• 🏠 Home workstation → Access from your phone on the couch
• ☁️ Cloud VM → Chat from any device, anywhere
• 💻 Work laptop → Continue conversations from your personal phone

The key: run CC Chat Kit on the same machine where Claude Code is installed and authenticated. Then connect to it remotely.

What's Included

1. Server (cc-chat-server) - A Bun server that wraps the Claude Code CLI, exposing it via WebSocket with streaming support
2. React Client (cc-chat-react) - A React hook for building chat UIs that connect to the server

This project wraps the [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) (Anthropic's official terminal tool) to enable building web-based interfaces. It does **not** use the Anthropic API directly—it spawns the CLI as a subprocess.

How It Works

React App ◄──WebSocket──► Bun Server
                              │
                         Bun.spawn()
                              ▼
                         Claude CLI

The server spawns Claude CLI with `--output-format stream-json` and parses the streaming output, broadcasting events to connected WebSocket clients.

Features

• Streaming - Real-time token streaming as Claude responds
• Tool Visibility - See which tools Claude is using and their results
• Todo Tracking - Display Claude's task list from TodoWrite
• Session Resume - Continue previous conversations
• Reconnection - Automatic reconnect with exponential backoff
• **