Skip to content
Reelkit
Menu
EnglishעבריתInstall Reelkit

Install Reelkit

One npm command, then log in and start a project your agent can make a video in.

You need
Node 22 or newer
ffmpeg

For agents

/llms-full.txt/llms.txt

Everything on this site, and the skill itself, is one plain markdown file in English. Point an agent at it when it needs the whole picture.

Set up

Run these in a terminal, in this order.

  1. Check the requirements

    Reelkit needs Node 22 or newer and ffmpeg on your path. Optional: yt-dlp, only if you give reelkit ref download a link rather than a file (macOS: brew install yt-dlp, or pipx install yt-dlp).

    node --version
ffmpeg -version

  2. Install Reelkit

    This one line is the whole install. It puts the reelkit command on your path. With pnpm, pnpm add -g reelkit-cli does the same. The skill installs itself: the first time you run reelkit init <name> or log in with reelkit auth login, Reelkit puts it into every supported coding agent it finds on your machine.

    npm install -g reelkit-cli

  3. Log in

    An account is free. When you log in yourself, run reelkit auth login: your browser opens on the approval page, you sign in there with an email link, and the command waits while you approve. An agent cannot wait like that. It runs reelkit auth login --start, shows you the link it returns, with the code already in it, and then runs reelkit auth login --finish.

    # you, in a terminal: your browser opens and the command waits while you approvereelkit auth login
# an agent: show the link, then finishreelkit auth login --start
reelkit auth login --finish

  4. Start a project

    This creates a folder named after the project, with plan.json, assets/, src/ and out/. Then ask your agent to make a video in that folder.

    reelkit init <name>

  5. Put the skill into your agents yourself (optional)

    You can skip this step: the skill, and a /reelkit-video command where the agent supports one, are already in place after the steps above. Run it to install or reinstall the skill yourself. Add --agent <id> to name one agent, or --force to replace a copy that is up to date.

    reelkit install

If npm prints a notice about esbuild's install script, the install still worked.

Where the skill goes

Reelkit copies the skill into every supported agent it finds on your machine, when you run reelkit init, reelkit auth login or reelkit install. You do not move any files yourself.

Claude Code

Skill
~/.claude/skills/reelkit
Command
~/.claude/commands/reelkit-video.md
Only this agent
reelkit install --agent claude

Codex

Skill
~/.codex/skills/reelkit
Command
~/.codex/prompts/reelkit-video.md
Only this agent
reelkit install --agent codex

Cursor

Skill
~/.cursor/skills/reelkit
Command
This agent has no command file.
Only this agent
reelkit install --agent cursor

Gemini CLI

Skill
~/.gemini/skills/reelkit
Command
This agent has no command file.
Only this agent
reelkit install --agent gemini

Shared agents folder

Skill
~/.agents/skills/reelkit
Command
This agent has no command file.
Only this agent
reelkit install --agent agents

Turn automatic install off

reelkit init and reelkit auth login install the skill and keep it up to date on their own. Set this variable to stop that. reelkit install still works when you run it yourself.

export REELKIT_NO_AUTO_INSTALL=1

Your first video

The sequence an agent runs: log in, set up a project, plan, record, compose, check and render. If you log in by hand, run reelkit auth login instead of the first three lines.

reelkit auth login --start
# show the person the link, and wait for them to approvereelkit auth login --finish
reelkit init my-video --aspect 9:16
cd my-video
# write plan.jsonreelkit plan check
reelkit assets voices
reelkit assets voiceover --all
reelkit assets search "city skyline at night" --kind image
reelkit assets pull <id> --scene intro
# write src/Video.tsxreelkit check
reelkit preview
reelkit render