PluginInstalls cleanly

Make TikTok effects by chat

ehai

TikTok's official plugin: describe an AR effect, the agent builds it in the Effect House engine, shows a live preview with sliders and can publish it.

Works with
Claude Code, Codex CLI
Good for
Graphic designers

What it does

Effect House is TikTok's tool for making camera effects: face and hand tracking, stickers, makeup, 3D objects, text and small tap games. Normally you build them by hand in the desktop app. EffectHouse AI lets you describe the effect in plain words and has your assistant build it in the real Effect House engine.

You see the result in a live preview page on your computer (or on your phone), tune it with sliders the assistant adds, and, when you confirm, publish it to your Effect House account. You can also ask how your published effects are doing.

The plugin is a thin starter. The first time it runs it downloads TikTok's runtime and the Effect House engine (about 0.5 to 0.6 GB, about 1 GB on disk), checks them against SHA-256 values pinned in the repo, and starts a local service. All the working code is in that download, not in the repo. You sign in by scanning a QR code with the TikTok app.

Example prompts

  • "Make an effect that puts sparkles around my face."
  • "Build a tap game where I catch falling stars."
  • "Add a slider so I can change the sparkle colour."
  • "How are my published effects doing?"

How to install

claude plugin marketplace add tiktok/effect-house-agent-plugins
claude plugin install ehai@effect-house

How to use it

Open a new session and describe the effect, for example "Make an effect that puts sparkles around my face". The first call shows a QR code to sign in with the TikTok app.

Check it works

The README gives a third, optional setup command that downloads everything in the foreground and ends with READY or FAILED: node ~/.claude/plugins/cache/effect-house/ehai/<version>/scripts/start.mjs setup (claude plugin list --json shows the folder as installPath). Without it, the first conversation only downloads (the ehai_installing tool reports progress) and the tools appear in the next one. Then ask for a simple effect: it shows a QR code to sign in and then opens the preview. If something stops, run ehai doctor as the README describes.

Common problems

Other assistants

  • Codex: codex plugin marketplace add tiktok/effect-house-agent-plugins then codex plugin add ehai@effect-house (README; optional setup: node ~/.codex/plugins/cache/effect-house/ehai/<version>/scripts/start.mjs setup); start a new task after installing or updating. Codex runs no hooks — https://github.com/tiktok/effect-house-agent-plugins
  • Gemini CLI: no Gemini route in the README and not in the Gemini CLI extensions gallery (checked 2026-11-05) — https://geminicli.com/extensions/

What to watch out for

  • Right after install, the first session downloads a runtime (36-38 MB) and the Effect House engine (493 MB on a Mac, 608 MB on Windows, about 1 GB unpacked) from TikTok's CDN (sf16-va.tiktokcdn.com) into ~/.ehai, in the background and without asking; sizes from runtime.json and engine.json at commit 16fd30f
  • The repo holds only two small starters (scripts/start.mjs, scripts/setup.sh); every other piece of code, including the hooks, the MCP servers and the daemon, comes in the downloaded runtime, which the Apache-2.0 licence does not cover. start.mjs checks the runtime against a SHA-256 pinned in the repo, and that pin changes with each daily version
  • Claude Code hooks (Codex runs none; hooks.codex.json is empty): on every prompt, UserPromptSubmit runs prompt-context (waits up to 5 s) and turn-telemetry (in the background); at Stop, agent-idle and turn-telemetry run in the background (4 s). Their code is in the runtime, not the repo. The README says prompt-context passes the start of your prompt to the local daemon and turn-telemetry hands the prompt to the local engine, which keeps only its length. If the runtime is missing, start.mjs skips them silently
  • Usage analytics are on by default (README): feature use, counts, durations, prompt lengths, a per-machine id and, when signed in, your Effect House account id, badge level and country go to TikTok's analytics collector. Set EHAI_TELEMETRY=off in the host's environment to send nothing; this is a README claim, as the code is in the runtime
  • Once a day the daemon reads plugin.json and support.json from raw.githubusercontent.com to check for updates (README: no identifier sent); EHAI_UPDATE_CHECK=off turns it off
  • Needs a TikTok account; the sign-in session is stored in ~/.ehai. Publishing uploads your effect and project with an 'AI record' (prompt counts and lengths, editing steps). Model search sends search words to api.sketchfab.com
  • The README also offers a 'paste this prompt' route: the agent curls claude_install_update.md from GitHub and follows it, which also sets autoUpdate for the effect-house marketplace in ~/.claude/settings.json. Use the commands above instead
  • macOS on Apple silicon or Windows x64 only (Intel Macs are not supported); needs Node.js 20+. On a Mac without Node, setup.sh downloads the runtime and runs a second setup script from it, which (README) writes ~/.ehai/bin/node and adds one line to your login profile
  • Projects saved by the plugin need Effect House 5.16.0 or later to open; an older Effect House can no longer open them
  • Version 0.0.128 is a git tag, not a GitHub release; a new version comes out almost every day (as of 2026-11-05)

Licence and author

Licence
Apache-2.0
Author
Effect House (tiktok)
Source code
github.com/tiktok/effect-house-agent-plugins

How we tested it

We installed it on an empty test computer on 5 Nov 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not yet used on real work.

Technical details of the test
Date
5 Nov 2026
Method
Intake sandbox run on 2026-11-05 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed ehai@effect-house with the Claude Code command line.

Checked again on 5 Nov 2026

Alternatives

  • HyperFrames — has your assistant make short MP4 videos for social posts from web pages (finished clips, not camera effects)
  • Motion Graphics Skill Pack — skills for launch videos, animated charts and short reels rendered to MP4

FAQ

  • Q: Does my prompt text go to TikTok? A: The README says prompt text stays on your machine; the code that handles it is in the downloaded runtime, so we could not check it in the repo. Analytics send prompt lengths and feature use unless you set EHAI_TELEMETRY=off. Anything a tool returns still goes to your assistant's model provider.
  • Q: Will it publish without asking? A: The README says nothing about a project leaves your machine before you confirm a submission (apart from phone previews and image generation you ask for). Check each publish step yourself.
  • Q: How do I remove it? A: Run ~/.ehai/runtime/current/bin/ehai uninstall --yes (macOS), then claude plugin uninstall ehai@effect-house.

Sources

  • github.com/tiktok/effect-house-agent-plugins
  • github.com/tiktok/effect-house-agent-plugins/blob/16fd30f7cd4aceb7451b844045f00422fe8c2830/.claude-plugin/plugin.json
  • github.com/tiktok/effect-house-agent-plugins/blob/16fd30f7cd4aceb7451b844045f00422fe8c2830/hooks/hooks.json
  • github.com/tiktok/effect-house-agent-plugins/blob/16fd30f7cd4aceb7451b844045f00422fe8c2830/scripts/start.mjs
  • github.com/tiktok/effect-house-agent-plugins/blob/16fd30f7cd4aceb7451b844045f00422fe8c2830/runtime/engine.json
  • github.com/tiktok/effect-house-agent-plugins/blob/16fd30f7cd4aceb7451b844045f00422fe8c2830/runtime/runtime.json
  • effecthouse.tiktok.com