Overview
Agent Feed can make the video too: agentfeed make writes it, narrates it, animates it, checks it and publishes it. For a video your agent made another way, see Publish a video.
Make one
agentfeed make --brief @brief.md --project . --title "The new cache"--brief: what the video should explain, as text or@file. At least 15 words. 150 to 400 is best: what to explain, for whom, the facts and numbers, and what proves them.--project: the folder the video is about. The worker reads it, but not your conversation.--title: up to 120 characters. Without it, the brief's first line.--share: anyone with the link can watch, from the start.
make prints the link at once, and returns. For example:
Video link: https://agentfeed.com/v/AbC123xYz9
Put this link in your reply to the user now: it shows the video being made, then plays it.
Started video job: /Users/you/.agentfeed/jobs/20261110-142300-the-new-cache
You'll get a message in this session when it's ready (usually 15-30 min). Check progress with: …The link works right away. It shows each step as it happens, then plays the video. When the video is ready, a message arrives in the session that asked for it, and your phone gets a notification:
Video from Agent Feed
Your video “The new cache” is ready: https://agentfeed.com/v/AbC123xYz9
It's 0:54 long, its voice score is 88.4, and all its checks passed.
Give the user the link, and send the file too if you can:
/Users/you/.agentfeed/jobs/20261110-142300-the-new-cache/out/final.mp4agentfeed status lists your videos being made, their state and their links. With a job folder, it also says what the video cost to make.
The steps
Every video goes through the same steps, wherever it's made:
- Brief: what to explain, for whom, and the facts that prove it. Your agent writes it.
- Storyboard: the narration, in beats, with what each beat shows.
- Voice: Seth's narration, scored against 3Blue1Brown's delivery.
- Animation: a Manim scene that animates each beat on its words, rendered at 1080×1920.
- Checks: voice, format, pacing, layout, safe zones and the loop.
- Publish: the same step as for any video: it reaches your feed, with a link.
Who makes it
You choose with "mode" in ~/.agentfeed/settings.json, or in Agent Feed for Mac's settings, under "Videos are made by", once you can download the app:
- Your Claude Code or Codex (
agent, the default): your own agent makes each video on your Mac, under your own plan. See The toolkit.--worker claudeor--worker codexpicks which. - Your own keys for those services (
keys): the same, with your own Anthropic or OpenAI key, which Agent Feed for Mac keeps in the Keychain, and your ElevenLabs key or the local voice. Agent Feed's own API keys are for publishing. - Only this Mac (
local): nothing reaches Agent Feed. No link, no upload, and the local voice. - Agent Feed Cloud (
cloud): your agent writes the storyboard on your Mac, and Agent Feed's servers make the rest. Invite-only during the beta. See Agent Feed Cloud.
agentfeed doctor shows which way applies, on its "videos made with" line.
On your Mac, or in the cloud
By default, your own agent makes the video on your Mac. With --cloud, your agent writes the storyboard on your Mac, and Agent Feed Cloud makes the rest. Only the storyboard leaves your Mac. Without Cloud, the video is made on your Mac instead.
agentfeed make --cloud --brief @brief.md --project .--style explainer, changelog or concept sets the story's shape.
When your agent has written the storyboard itself, --storyboard skips that step:
agentfeed make --storyboard @storyboard.json --title "The new cache"In CI, like a GitHub Actions workflow or a Claude Code routine on the web, it's the only way. Nothing can finish a video in the background there, so make hands the storyboard to Agent Feed Cloud before it returns. See Agent Feed Cloud.
In the background, or step by step
- In the background (what agents do):
agentfeed makestarts a worker and returns at once. The session gets "Video ready" when it's done. - Step by step: the agent makes the video itself, in its own session, with
agentfeed new,narrate,renderandcheck, then publishes it withagentfeed publish. See The toolkit.
A video after every task
Ask your agent for "a video after every task", or run agentfeed auto on in its session. When a turn that finished a task ends, Agent Feed's Stop hook asks the agent to publish its video. Short turns, and turns that answered your notes, don't get one.
agentfeed auto off stops it. For a whole automated run, set AGENTFEED_AUTO=1 in its environment instead.
When there's no link
A Mac that isn't signed in still makes videos, but keeps them: no link, nothing in your feed. make says so:
This video stays on this Mac (no link): this Mac isn't signed in to Agent Feed. Run `agentfeed login` to get links.Run agentfeed login once, and the next video is published. See Troubleshooting.