Skip to content
claudemods

Reels, a Claude Code mod: watch Claude Code YouTube Shorts in a pane while it works

YouTube Shorts in a Claude Code pane: plays while Claude works, pauses when Claude is done.

Permissions

  • Reads filesCan read files and list directories on your machine ($.fs.read / list / stat / exists).
  • Runs commandsCan run shell programs on your machine ($.process.run / spawn). Check the source for exactly which ones.
  • NetworkCan make HTTP requests or talk to MCP servers ($.http.fetch / $.mcp.*).
  • Changes the UIDraws into the Claude Code interface: bands, panes, status text, toasts (ui.render / $.ui.*).
  • Adds commands/toolsRegisters new slash commands or tools that you or Claude can invoke ($.command.register / $.tool.register).
tested with
v2.1.310
last tested
requires
Claude Code ≥ 2.1.287
surfaces
pane

Install inside Claude Code:

/plugin install reels --marketplace hamzafer/claude-code-mods
All install options ↓

What does this mod do?

Reels is a community mod by Hamza Zafar (hamzafer), part of his claude-code-mods collection. It gives you Claude Code YouTube Shorts in a side pane: run /reels, and a vertical video plays while Claude works on your prompt. When the turn finishes, the video pauses and the pane says "Claude's done, your turn".

The picture is a mirror of a hidden Chrome window, drawn into the terminal as an image, so your terminal has to be able to show images. Under the picture the pane has four buttons: Prev (k), Next (j), Mute (m) and Stop (x), and a status line such as "▶ Playing while Claude works".

Install

The install block above adds the author's marketplace and installs the plugin from it. Reels needs one more step, once. It looks for Playwright in its own folder, and if it is missing, /reels replies with the command to run, which is npm install --prefix ~/.claude-mods/reels playwright@1.63.0. You also need Node.js and Google Chrome. Then run /reels. To try the plugin without installing, point Claude Code at a local clone with --plugin-dir.

$ install reels

Requires Claude Code ≥ 2.1.287

Installs from the author's own marketplace: hamzafer/claude-code-mods

  1. 1.One line, inside Claude Code

    /plugin install reels --marketplace hamzafer/claude-code-mods

    Paste into a running session (v2.1.275+). Claude Code asks to add the marketplace first.

  2. 2.From your shell

    claude plugin marketplace add hamzafer/claude-code-mods
    claude plugin install reels@claude-code-mods

    Then run /reload-plugins in any session that is already open.

  3. 3.Try it without installing

    git clone https://github.com/hamzafer/claude-code-mods
    claude --plugin-dir ./claude-code-mods/mods/reels

    Loads the mod for one session only. Nothing is added to your settings.

How it works

The mod is one hooks module, register.tsx, plus a Node helper, helper/reels.cjs. On /reels the module opens the pane and spawns the helper, which launches a headless Chrome on https://www.youtube.com/shorts through Playwright and streams its screen as PNG frames, about 15 a second. The module talks to the helper over a Unix socket. Turns drive it. This is from register.tsx:

on('turn.start', async ($, e, next) => {
  live.isWorking = true
  if (await send($, '/play')) await update($, status, () => 'playing')
  return next(e)
})

send makes an HTTP request to http://reels/play through the socket at ~/.claude-mods/reels/ctl.sock; the host name is a placeholder, and nothing leaves the machine on that call. The helper writes frames to three rotating files under ~/.claude-mods/reels/frames, and the module hands the newest one to the pane with $.ui.blit. Between turns the helper pauses every video and injects an overlay, and a small script in the page keeps videos from starting while paused.

Customize it

There are no settings. You control it with the arguments of /reels: no argument starts or reopens it, login opens a visible window for cookies or sign-in, and stop ends it. In the pane, k and j move to the previous and next Short, m toggles mute, and x stops. Mute state is kept in the plugin's state, so the button label survives a redraw.

Permissions & safety

We read every file the plugin can run: the hooks module, the helper, the manifest and hooks.json. There is no package.json, no install script, no minified code and no binary. Here is what we found:

  • Network: the helper opens YouTube in Chrome, so everything YouTube normally does happens in that browser (video, cookies, your account if you sign in). The mod's own code sends nothing anywhere else and has no telemetry. $.http.fetch is used only to talk to the local Unix socket.
  • Processes: /usr/bin/env node helper/reels.cjs (argv array, no shell), which launches Google Chrome through Playwright. The helper runs until /reels stop, the Stop button, session end, or Chrome closing.
  • Writes: only under ~/.claude-mods/reels: the socket, the frames, and a persistent Chrome profile (profile/) that holds YouTube cookies and any login you add. Nothing is written to ~/.claude, settings.json, shell files or LaunchAgents.
  • Secrets: the module reads HOME only.
  • Opt-in and gating: nothing starts until /reels. No hook blocks or rewrites tool calls or prompts, and the mod injects no text into the prompt.
  • External requirements: Node.js, Google Chrome, Playwright (installed by you with npm) and internet access to YouTube. Playwright runs with --autoplay-policy=no-user-gesture-required and without Chrome's automation flag.
  • License: MIT, with a LICENSE file in the repository.

claude plugin validate passed with one non-blocking warning: no icon. claude plugin test ran the author's three tests and all passed on Claude Code 2.1.310. We did not run YouTube playback ourselves. Whether Shorts keep working depends on YouTube's pages and its terms, which are outside the mod.

Reads files
Can read files and list directories on your machine ($.fs.read / list / stat / exists).
Runs commands
Can run shell programs on your machine ($.process.run / spawn). Check the source for exactly which ones.
Network
Can make HTTP requests or talk to MCP servers ($.http.fetch / $.mcp.*).
Changes the UI
Draws into the Claude Code interface: bands, panes, status text, toasts (ui.render / $.ui.*).
Adds commands/tools
Registers new slash commands or tools that you or Claude can invoke ($.command.register / $.tool.register).

Compatibility & troubleshooting

Tested on Claude Code 2.1.310. The pane draws only on the terminal surface; elsewhere it shows a short notice. Status messages in the pane tell you what is wrong:

  • "Needs Playwright": run the npm command that /reels printed.
  • "Chrome did not start": run claude --debug and read the helper's output, which is logged to the debug log.
  • "YouTube wants cookie consent": run /reels login, accept the dialog in the window, close it, then run /reels again. Login and the pane cannot run at once because the profile opens in one Chrome at a time.
  • A blank pane: the first frame can take a few seconds; the pane shows "Waiting for the first frame…".

FAQ

Does Reels start playing on its own?
No. Nothing starts until you run /reels. The author's test checks that a turn without /reels spawns no helper process. Until then the mod only registers the command.
What do I need installed besides the mod?
Node.js, Google Chrome, and Playwright 1.63.0 in the mod's own folder. If Playwright is missing, /reels prints the exact npm install command and starts nothing.
Does it pause when Claude is done?
Yes. A turn start sends /play to the helper and a main-agent turn completion sends /pause, which also puts a dark "Claude's done, your turn" overlay on the page. Subagent turns do not pause it.
Do I have to sign in to YouTube?
Not necessarily. /reels login opens a visible Chrome window so you can accept cookies or sign in once. The profile is kept in the mod's own folder, so you do not repeat it.
How do I stop it?
Run /reels stop or press the Stop button in the pane. Both ask the helper to quit, which closes the hidden Chrome and removes its socket.
cc-arcade Games Above the Prompt running in Claude CodeFeatured

cc-arcade Games Above the Prompt

Snake, Tetris, Doom, 2048 and more games above the Claude Code prompt, plus a pet fed by Claude's work.

  • above-prompt
  • toast
  • Intercepts tool calls
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.291

Done Toast running in Claude CodeFeatured

Done Toast

A "Done in 2m 14s" toast and a short chime when a long Claude turn finishes, plus an optional desktop notification.

  • toast
  • Runs commands
  • Changes the UI
  • Plays sound

tested with v2.1.310

More in Timers, todos, standups, Slash commands.