ClaudeMods
☰
All projectsCommunity submissionsPromptsToolsFree toolsGuidesSponsors1 feed slots leftDashboards & HUD325Usage & costs65Security & privacy67Memory & context27Workflows & CI342Git & code review42Multi-agent orchestration136Prompts & input33Notifications & reminders44Games & entertainment79Themes & appearance71Audio & multimedia13Tools & integrations125Development & debugging31Other109
EN
● 0 online · Views 0 times
SponsorsSubmit a project
GitHub repositories · by Chinteyley

tiktok-break

Watch TikTok inside Claude Code while Claude works, in a pane beside the transcript.

Translated

About this mod

An unofficial Claude Code plugin that plays your TikTok For You feed in a side pane while Claude works. It runs a headless Chromium on its own profile, screencasts the feed over the DevTools protocol into PNG frames, and repaints the pane through the terminal's kitty graphics protocol. Commands include /tiktok and /tiktok login; pane controls cover next/previous, pause, mute, like and repost. Requires macOS or Linux, a Chromium-based default browser, Bun on PATH, a kitty-graphics terminal, and a Claude Code build with function-hook mods. Note: it starts Chrome with the automation flag off to bypass TikTok's automation checks and performs real account actions, and writes ~0.5 MB PNG frames around 30 times per second. MIT licensed.

Installation

Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.

claude plugin marketplace add Chinteyley/tiktok-break
claude plugin install tiktok-break
Original text / README

tiktok-break

Watch TikTok inside Claude Code while Claude works, in a pane beside the transcript.

The TikTok pane docked beside a Claude Code session

Unofficial. Not affiliated with TikTok or Anthropic.

Commands

| Command | What it does | | --- | --- | | /tiktok | Plays your For You feed in a pane; run it again to close. | | /tiktok login | Opens a real browser window on the mod's profile so you can log in. Close it, then run /tiktok. |

The pane docks at the side, full height, when Claude Code is in its fullscreen layout and the terminal is at least 110 columns wide. In a smaller terminal it is a block above the prompt. Docked, a video is framed with its creator, likes, comments, saves and shares; above the prompt, the video alone.

Pane controls

Click a control under the picture, or press ctrl+x tab to give the pane the keyboard and use its key. Esc hands the keyboard back to the prompt.

| Key | Control | | --- | --- | | k | Previous video | | j | Next video | | p | Pause or play | | m | Mute or unmute | | l | Like | | r | Repost (again takes it back) |

A video that finishes moves on to the next by itself. Like and Repost are real actions on the account you logged in with.

Requirements

  • macOS or Linux
  • A Chromium-based browser (Chrome, Chromium, Brave, Edge, Vivaldi, Helium…) set as your default browser. Firefox and Safari can't be driven the way the pane needs. A default browser launched through env or flatpak isn't detected. A snap-packaged Chromium can't write the profile in ~/.config and won't work.
  • Bun on your PATH
  • For the pane, a terminal that draws the kitty graphics protocol. Built and tested in Ghostty; kitty should work but is untested.
  • Claude Code with function-hook mods. Built against 2.1.289; that API is early access and may change between releases.

Install

claude plugin marketplace add Chinteyley/tiktok-break
claude plugin install tiktok-break@tiktok-break

Then start Claude Code, or run /reload-plugins in a session that is already open.

To work on the mod instead, clone the repository and load the folder directly; edits to it reload live:

git clone https://github.com/Chinteyley/tiktok-break
claude --plugin-dir ./tiktok-break

How it works

viewer/viewer.ts runs a headless Chrome on a profile of its own (~/Library/Application Support/tiktok-break on macOS, ~/.config/tiktok-break on Linux), opens the For You feed and screencasts it over the DevTools protocol. Each frame is written to one PNG file, and the mod (hooks/register.tsx) repaints the pane's picture from that file through the terminal's graphics protocol. The controls go the other way over a Unix socket: the viewer presses TikTok's own keyboard shortcuts in the page. Sound comes from that Chrome.

/tiktok login opens a plain app window of the same browser on the same profile, which is how the pane comes to be logged in.

Good to know

  • Automation and TikTok's terms. TikTok drops likes from a browser that says it is automated, so the viewer's Chrome is started to report a regular Chrome name with the automation flag off. That gets around TikTok's automation check on your account, and TikTok could restrict the account for it. Use it at your own risk.
  • Disk writes. Frames are PNG files of roughly half a megabyte, written about 30 times a second while the pane plays.
  • Photo posts are shown with their whole item and do not move on by themselves; press Next.
  • Clicks and typing inside the picture are not possible. Use the /tiktok login window for comments and search.
  • Logged out, TikTok covers the feed with a login dialog after a few videos. The pane shows the dialog; run /tiktok login.

Development

claude plugin validate .
claude plugin test .
tsc -p .

tsc needs the type declarations Claude Code lays into .claude-plugin/types/ the first time it loads the mod; that folder is not checked in.

License

MIT

Similar projects