Skip to content

Explainer videos and product demos made by your AI agent. Free and open source: a local voice (Kokoro), word timing (Whisper) and a canvas renderer turn a script into a narrated MP4.

Add the copy-paste prompt to the README, tell agents to clone first, link the www docs

Vincent Schmalbachfb03c350ab8b
diff --git a/AGENTS.md b/AGENTS.md
index 1c54b17..eb9566d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -11,10 +11,19 @@ this computer, and Whisper writes down when each word is spoken. Chrome draws
the frames in the background, explainroo adds music and sound effects, and
ffmpeg makes the MP4. No API key is needed unless the user wants AI images.
-The full documentation for people is at https://explainroo.com/docs/.
+The full documentation for people is at https://www.explainroo.com/docs/.
## Before you start
+If the user pasted the prompt from the README or explainroo.com and you are
+not in an explainroo folder yet, clone it into the current folder first,
+unless the user named another place:
+
+```bash
+git clone https://github.com/vincentsch/explainroo.git
+cd explainroo
+```
+
Run this once in the explainroo folder:
```bash
diff --git a/README.md b/README.md
index 9cb3f04..4325e59 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,12 @@
## Point your AI agent (Claude Code, Codex, Pi and others) at this repo and tell it what video you want.
+Copy this into your AI agent and put your topic in place of the brackets:
+
+```text
+Make me a short explainer video about [your topic]. Use explainroo for it: clone https://github.com/vincentsch/explainroo, read its AGENTS.md and follow the steps.
+```
+
> Right now explainroo works best with Claude Code and Opus 5.5.
[![Watch the explainroo video](docs/media/intro.gif)](https://github.com/vincentsch/explainroo/releases/download/v0.1.0/explainroo-intro.mp4)
@@ -34,8 +40,8 @@ ends up in `videos/<name>/out/video.mp4`.
## More
-- The full documentation and a library of videos made with explainroo:
- [explainroo.com](https://explainroo.com)
+- The full documentation and more videos made with explainroo:
+ [explainroo.com](https://www.explainroo.com)
- The source of three example videos: [examples/](examples/)
## The watermark
diff --git a/src/cli.js b/src/cli.js
index a758eaa..2c92f49 100644
--- a/src/cli.js
+++ b/src/cli.js
@@ -41,7 +41,7 @@ Reference
doctor check ffmpeg, Chrome and the speech models (--fetch downloads them)
Options: --json for machine-readable output. The project defaults to the current folder.
-Docs: AGENTS.md (for coding agents) and https://explainroo.com/docs/`;
+Docs: AGENTS.md (for coding agents) and https://www.explainroo.com/docs/`;
function parseArgs(argv) {
const pos = [];