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-pluginsclaude plugin install ehai@effect-houseHow 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
- Tools don't appear after install — the engine is still downloading; wait for READY and start a new conversation — https://github.com/tiktok/effect-house-agent-plugins
- Download fails behind a company proxy — set
HTTPS_PROXYand, for a proxy that re-signs HTTPS,NODE_EXTRA_CA_CERTS— https://github.com/tiktok/effect-house-agent-plugins - "Cannot add marketplace effect-house: its source doesn't match" — remove the old marketplace with
claude plugin marketplace remove effect-house, then add it again — https://github.com/tiktok/effect-house-agent-plugins - Intel Mac — not supported; the plugin says so and stops — https://github.com/tiktok/effect-house-agent-plugins
Other assistants
- Codex:
codex plugin marketplace add tiktok/effect-house-agent-pluginsthencodex 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.
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), thenclaude 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