Docs
Everything runs on your computer, driven by your AI coding agent: Claude Code, Codex or any other agent that can run commands and edit files. These pages cover installing the kit, setting up your brand, and making each kind of reel.
Install
You need Node.js 22.17 or newer, ffmpeg and an AI coding agent that can run commands, edit files and view images. The kit ships ready-made skills for Claude Code and Codex (.claude/skills with CLAUDE.md, .agents/skills with AGENTS.md), which are the two we test with. Other agents, such as Gemini CLI or Grok, follow the same instructions: point them at AGENTS.md. Board reels also need Python 3 and an ElevenLabs account.
npx aeyho init my-reels
This opens your browser to confirm a code (sign in with the email you bought with), downloads the kit for the formats you own, installs everything, and checks your machine. On a computer without a browser, log in with your license key first:
npx aeyho login --key YOUR-LICENSE-KEY
npx aeyho doctor re-runs the machine check at any time.
Set up your brand
cd my-reels claude # or codex, gemini, or your agent's command > set up my brand
Your agent asks about your business, handle, colours, tone, narrator voice and audience, then writes brand/brand.json. Every reel reads it, so you only do this once. Add your logo as brand/logo.svg or brand/logo.png if you want it on silent reels.
Make a board reel
Narrated, 90 to 140 seconds. Ask for one in plain words:
> make a board reel about why our sourdough takes two days
- The agent researches, asking you for the details only you know, and writes a nine-part script.
- It stops and shows you the script and a storyboard. Nothing costs money until you approve.
- It builds the scenes against a free draft narration, then records the real voice with your ElevenLabs key (put
ELEVENLABS_API_KEY=...in.env). - It adds the music and renders
episodes/<slug>/reel.mp4, a caption and a thumbnail.
npm run studio opens a preview of every reel, the example and a gallery of every prop.
Make a silent reel
No voice, 15 to 30 seconds, dark. Best for anything that flows, runs out or backs up: sell-outs, queues, delays, returns.
> make a silent reel about why our croissants sell out by 9
- The agent checks the topic against the format's test and suggests ones that pass.
- It writes a beat plan and stops for your approval.
- It builds the animated diagram, checks it with the captions hidden, and renders
productions/<slug>/out/reel.mp4with a caption and a cover.
The example lives in silent/examples/second-bake; node silent/tools/build.mjs second-bake renders it.
Updates and machines
npx aeyho update(inside your project) installs the latest kit. It never touchesbrand/, your episodes, your productions or prop packs you created.- Your licence includes a year of updates and works on up to 3 machines. See and free machines in your dashboard, or run
npx aeyho logouton the old one.
Troubleshooting
- "No active license on this account": you signed in with a different email from the one you bought with.
- "Already active on 3 machines": deactivate one in the dashboard.
- "License key not found" right after buying: wait a minute and try again.
- Silent reels fail to render: run
npx playwright install --only-shell chromiumin the project. - Narration fails: check
ELEVENLABS_API_KEYin.envand your ElevenLabs credits. - Anything else: ask your agent in the project ("the render failed, here is the error"), or email support@aeyho.com.