clui-cc-claude-overlay — Claude Code skill: macOS overlay
This skill puts a floating macOS overlay on top of Claude, with tabbed sessions, tool-call approval and voice input.
npx skills add reason-machines/trending-skills --skill clui-cc-claude-overlay -a claude-codeWhat clui-cc-claude-overlay does
The skill sets up Clui CC, a transparent desktop overlay for macOS that wraps the Claude CLI. Every tab spawns its own claude -p --output-format stream-json process, and RunManager parses the NDJSON stream into events for the UI. Tab state moves through ControlPlane: connecting, idle, running, then completed or failed.
Tool calls are intercepted by PermissionServer through PreToolUse HTTP hooks, bound to localhost. The renderer gets a permission_request event and waits for your call: approve or deny. Sessions resume with --resume <session-id>, and conversation history stays on the machine. Voice input runs through Whisper, no API key involved.
The overlay is macOS 13+ only. You need Node.js 18+, Python 3.10+ with setuptools on 3.12+, an authenticated Claude CLI and Whisper CLI. The app is unsigned, so macOS blocks it on first launch — open it via System Settings → Privacy & Security → Open Anyway. That is a good moment to check where the build came from before you allow it.
What it helps with
- run several Claude sessions in separate tabs
- approve or deny tool calls before they execute
- dictate prompts by voice without sending audio to a cloud
- resume an earlier session by its id
- set up the toolchain to build the overlay from source
Example prompts for the agent
- install clui-cc-claude-overlay and launch the overlay
- set up tool-call approval through PermissionServer
- turn on Whisper voice input for prompts
How to install clui-cc-claude-overlay
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill clui-cc-claude-overlay -a claude-code2Manually: put the files in place
~/.claude/skills/clui-cc-claude-overlay/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/clui-cc-claude-overlay/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill clui-cc-claude-overlay -a codex2Manually: put the files in place
.agents/skills/clui-cc-claude-overlay/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill clui-cc-claude-overlay -a cursor2Manually: put the files in place
.cursor/skills/clui-cc-claude-overlay/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills clui-cc-claude-overlay2Manually: put the files in place
.github/skills/clui-cc-claude-overlay/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill clui-cc-claude-overlay -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/clui-cc-claude-overlayManually: put the files in place
.devin/skills/clui-cc-claude-overlay/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill clui-cc-claude-overlay -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about clui-cc-claude-overlay
How do I install clui-cc-claude-overlay in Claude?
Run npx skills add reason-machines/trending-skills --skill clui-cc-claude-overlay -a claude-code. The skill lands in ~/.claude/skills/clui-cc-claude-overlay/SKILL.md.
What does clui-cc-claude-overlay do?
It adds a floating macOS overlay around Claude: tabbed sessions, a tool-call approval UI, Whisper voice input and conversation history.
What do I need to run the overlay?
macOS 13+, Node.js 18+, Python 3.10+ and an authenticated Claude CLI. Voice input needs Whisper CLI.
