ClaudeTok

A tiny macOS overlay that pops up a TikTok window while Claude Code is thinking, and hides it when the response finishes. Like a "loading screen" but more entertaining. Maximum vibe-coding.

• Native macOS app (~125 KB compiled). Single WKWebView, no Electron, no browser dependency.
• Always-on-top floating window, follows you across every macOS Space.
• Pauses Spotify while TikTok is on-screen, resumes when it disappears.
• Arrow keys scroll the TikTok feed.
• Menu bar icon to enable / disable / pause without touching config files.

Install

One-line (recommended)

curl -fsSL https://raw.githubusercontent.com/altidj422-tech/ClaudeTok-Extension-/main/quick-install.sh | bash

This downloads the latest pre-built binary, copies everything into ~/.claude/extensions/tiktok-overlay/, and patches your ~/.claude/settings.json with the four hooks.

From a release zip (manual)

1. Download claudetok-vX.Y.Z.zip from the Releases page.
2. Unzip it.
3. In Terminal: cd claudetok && ./install.sh

From source (devs, requires Xcode Command Line Tools)

git clone https://github.com/altidj422-tech/ClaudeTok-Extension-.git
cd ClaudeTok-Extension-
./build.sh
./install.sh

Then

Restart Claude Code so the new hooks load. Next prompt → TikTok appears.

First launch on macOS

The binary is not code-signed (would cost $99/year), so macOS will show:

"TikTokOverlay" cannot be opened because the developer cannot be verified.

One-time fix: open Finder, navigate to ~/.claude/extensions/tiktok-overlay/, right-click TikTokOverlay → Open → click Open in the dialog. macOS remembers your choice forever.

Permissions to grant on first run

macOS will prompt for each. Both required for full functionality:

Permission	Why
Automation → Spotify	To pause/resume your music while TikTok is on-screen
Input Monitoring	To capture up/down arrows so you can scroll the TikTok feed

Grant each in System Settings → Privacy & Security when prompted.

Menu bar

A ▶︎ icon appears in your menu bar. Click it for:

• Enabled — master switch, persists across restarts
• Pause until I quit Claude Code — temporary off, resets on next launch
• Show Now / Hide Now — manual triggers
• Quit Overlay — kills the binary (next Claude Code session auto-relaunches it)

How it works

• prelaunch.sh runs on SessionStart → launches the binary hidden off-screen so TikTok pre-loads
• show.sh runs on UserPromptSubmit → sends SIGUSR2 → window slides to bottom-right
• hide.sh runs on Stop → sends SIGUSR1 → window slides off-screen
• stop.sh runs on SessionEnd → kills the binary entirely

The binary uses a custom NSWindow subclass that overrides constrainFrameRect (so we can park it at (-10000, -10000)), and a WKUserScript injected at document-start that overrides document.visibilityState (otherwise TikTok's React app refuses to bootstrap when the window is off-screen).

Uninstall

~/.claude/extensions/tiktok-overlay/stop.sh
rm -rf ~/.claude/extensions/tiktok-overlay
# Manually remove the four hook entries from ~/.claude/settings.json

License

MIT — see LICENSE.