Agent skill · software engineering · aradotso
clui-cc-claude-overlay
Command Line User Interface for Claude Code — a floating macOS desktop overlay with multi-tab sessions, permission approval UI, voice input, and skills marketplace.
Why this skill is useful
Adds specific command scripts for setting up and managing the Clui CC environment that are not widely known.
What it needs
Requires node, python, whisper-cli installed locally. Requires claude account access. About 6k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Clui CC — Claude Code Desktop Overlay Skill by ara.so — Daily 2026 Skills collection. Clui CC wraps the Claude Code CLI in a transparent, floating macOS overlay with multi-tab sessions, a permission approval UI (PreToolUse HTTP hooks), voice input via Whisper, conversation history, and a skills marketplace. It requires an authenticated claude CLI and runs entirely local — no telemetry or cloud dependency. --- Prerequisites Requirement Minimum Notes --- --- --- macOS 13+ Overlay is macOS-only Node.js 18+ LTS 20 or 22 recommended Python 3.10+ Needs setuptools on 3.12+ Claude Code CLI any Must be authenticated Whisper CLI any For voice input --- Installation Recommended: App installer (non-developer) On first launch macOS may block the unsigned app — go to System Settings → Privacy & Security → Open Anyway. Developer workflow Command scripts --- Key Shortcuts Shortcut Action --- --- ⌥ + Space Show / hide the overlay Cmd + Shift + K Fallback toggle (if ⌥+Space is claimed) --- Architecture Process flow 1. Each tab spawns claude -p --output-format stream-json as a subprocess. 2. RunManager parses NDJSON; EventNormalizer normalizes events. 3. ControlPlane manages tab lifecycle: connecting → idle → running → completed/failed/dead. 4. Tool permission requests arrive via HTTP hooks to PermissionServer (localhost only). 5. Renderer polls backend health every 1.5 s and reconciles tab state. 6. Sessions resume with --resume <session-id>. Project structure --- IPC API (window.clui) The preload bridge exposes window.clui in the renderer. Key methods: --- Working with Tabs and Sessions Creating a tab and sending a prompt (renderer) Resuming a past session --- Permission Approval UI Tool calls are intercepted by PermissionServer via PreToolUse HTTP hooks before execution. The renderer receives a permissionrequest event and must resolve it. --- Voice Input Voice input uses Whisper locally. It is installed automatically by install-app.command or via brew install whisper-cli. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/clui-cc-claude-overlay