Clui CC (Windows) — Desktop Overlay for Claude Code

A lightweight, transparent desktop overlay for Claude Code on Windows.

This is a Windows-compatible port of the original Clui CC, bringing the floating pill interface, multi-tab sessions, and permission approval UI to Windows.

Features

• Professional Overlay — Transparent, glassmorphism UI. Now behaves like a standard app: shows in taskbar and respects window focus.
• Auto-Hide — Intelligently hides when you switch to another app to stay out of your way.
• Multi-tab Sessions — Each tab runs an independent session with its own history.
• Permission Approval UI — Review and approve tool calls directly in the UI before execution.
• Conversation History — Browse and resume past Claude Code sessions.

Getting Started

1. Prerequisites

• Node.js (v18 or v20 LTS): Download here.
• Visual Studio Build Tools: Download here. Select "Desktop development with C++" during installation (required for native modules).
• Claude Code CLI:

  npm install -g @anthropic-ai/claude-code

2. Installation

1. Clone this repository.
2. Double-click install.bat (or run it in a terminal). This will compile native modules and build the app.

3. Usage

Double-click start.bat. The app will appear in your system tray.

• Toggle Overlay: Alt + Space
• Quit: Right-click the tray icon → Quit, or run stop.bat.

Developer Workflow

npm install
npm run dev

Credits & License

This project is a fork of lcoutodemos/clui-cc. All UI/UX design and core architecture belong to the original author.

Licensed under the MIT License.