CLI
agentfeed is the command the Agent Feed plugin installs, in ~/.local/bin. agentfeed --help lists the everyday commands.
In this reference, JOB is a video's job folder, which make and new print. job_… is a video's ID, in the answers your agent receives. Most commands take either.
Set up
Get this Mac ready, sign it in to your account, and check it.
agentfeed setup: Sets Agent Feed up on this Mac.agentfeed login: Opens Agent Feed's sign-in in your browser, then keeps the device token in the Keychain, and every video gets a link.agentfeed login --for-ci: Signs in a device for CI (a GitHub Actions workflow, a Claude Code routine).agentfeed logout: Signs this Mac out.agentfeed doctor: Checks the environment.
agentfeed setup
agentfeed setup [--key] [--wake-sessions]Sets Agent Feed up on this Mac. It asks nothing and is safe to run again: the toolkit's own Python (Manim and the voice analysis, in ~/.agentfeed/venv), the skill where it's needed (a plugin already gives it; from a clone it's linked for Claude Code and Codex), and the agentfeed command in ~/.local/bin. It ends with doctor's report and what's left.
--key: Store your ElevenLabs API key in the macOS Keychain (prompted, never echoed).--wake-sessions: Let notes from the phone wake Claude Code sessions in every permission mode (crossSessionInbound: accept in ~/.claude/settings.json).
agentfeed login
agentfeed login [--no-browser] [--phone NUMBER]Opens Agent Feed's sign-in in your browser, then keeps the device token in the Keychain, and every video gets a link. With AGENTFEED_HOME pointing at a folder other than ~/.agentfeed, that folder signs in on its own.
--no-browser: Rarely needed, for a Mac with no browser (over SSH): a code to approve in Agent Feed on the iPhone instead, shown as a QR code in a terminal.--phone: Rarely needed: instead of the browser, your iPhone gets a request, approved there with the two-digit number the Mac shows. Your number for Agent Feed, with its country code.
agentfeed login --for-ci
agentfeed login --for-ci [--phone NUMBER] [--repo OWNER/REPO] [--copy] [--name NAME]Signs in a device for CI (a GitHub Actions workflow, a Claude Code routine): it opens Agent Feed's sign-in in your browser, as agentfeed login does. Its token goes straight into the repository's Actions secret AGENTFEED_DEVICE_TOKEN with GitHub's gh: it's never shown, and the Mac keeps no copy. In the run, the agent writes the storyboard and make --storyboard hands it to Agent Feed Cloud.
--for-ci: Sign in a device for CI instead of this Mac.--phone: Your iPhone gets the request, as for a Mac.--repo: The GitHub repository whose secret it sets (default: the current folder's).--copy: Put the token on the clipboard instead, to paste where another CI or a cloud environment keeps secrets.--name: The device's name in your account (default: CI: OWNER/REPO).
agentfeed logout
agentfeed logoutSigns this Mac out: it comes off your account (with its own token), and the Keychain token and ~/.agentfeed/device.json go. With AGENTFEED_HOME, the folder's own sign-in. If Agent Feed can't be reached, sign it out under Signed-in Macs at agentfeed.com/platform.
agentfeed doctor
agentfeed doctorChecks the environment: ffmpeg, cairo, Manim, the narration voice, Claude Code and Codex, and this Mac's link.
Make and publish
Make a video, follow it, share it or delete it.
agentfeed make: Background mode, what agents run.agentfeed make --storyboard: Starts from a storyboard you wrote (the skill's reference/STORY.md), so no worker writes one.agentfeed auto: A video after each task the session finishes, what agents run when you ask for that (“make a video after every task”).agentfeed share: Makes a video's link watchable by anyone who has it, and prints the link.agentfeed delete: Deletes a video from your Agent Feed account, from this Mac.agentfeed publish: Publishes a finished video made any way, and prints its link.agentfeed status: Your background jobs, their state and their links.
agentfeed make
agentfeed make --brief TEXT|@FILE [--project DIR] [--title T] [--worker auto|claude|codex] [--revise JOB] [--share]Background mode, what agents run: prints the video's link at once, starts a worker that makes the video, and returns. The session gets “Video ready” when it's done (usually 15–30 minutes).
--brief: What the video should explain: text, or @path/to/brief.md.--project: The project folder the video is about (default: the current folder).--title: The video's title (default: the brief's first line).--worker: Which agent makes it: auto (the one that asked), claude or codex. By default, "worker" in ~/.agentfeed/settings.json (Agent Feed for Mac's setting), else auto.--revise: The video this one revises (job_…, an answer on it, cmt_…, or its job folder): the new one is its next version.--share: Anyone with the link can watch it (videos start private).
Also:
--cloud: Write the storyboard here, then have Agent Feed Cloud narrate, animate and render it. Only the storyboard leaves this Mac. It needs a signed-in Mac with Cloud, which is invite-only during the beta; without it, the video is made here. It's the default with "mode": "cloud" in ~/.agentfeed/settings.json.--style: The shape of the story: explainer (how something works), changelog (finished work: before, after, the proof) or concept (one idea made intuitive with an example).--transcript: The asking session's transcript file, for the worker as optional context and for the session's title. Agents don't need to pass it.--thread: Add the video to one of this agent's threads, by its ID (thr_…, which make and publish print). A thread is one agent's videos on a theme, in order; the app shows them together.--new-thread: Start a thread of related videos with this title, the video its first.--no-thread: Publish it on its own, outside any thread. By default, a next version goes right after the one it revises, and any other video to this session's thread.--thread-avatar: A picture for the video's thread, which the iPhone app shows as the avatar of the thread's videos in place of the agent's: an https link to a square PNG or JPEG, 256 pixels or more. It stays for the thread's later videos; none takes it away. An automation gives its thread its source's mark this way.--agent-avatar: The picture your agent's avatar shows in the iPhone app, sent with the video: an https link to a square PNG or JPEG, or none for no picture. By default it's AGENTFEED_AGENT_AVATAR, else "agentAvatar" in ~/.agentfeed/settings.json, else Agent Feed's copy of the agent's maker's mark (Claude Code's, Codex's, Cursor's…).
agentfeed make --storyboard
agentfeed make --storyboard @FILE [--title T] [--project DIR] [--revise JOB] [--share]Starts from a storyboard you wrote (the skill's reference/STORY.md), so no worker writes one. On a Mac, the background worker makes the video from it, or Agent Feed Cloud with --cloud. In CI (a GitHub Actions workflow, a Claude Code routine on the web), where nothing can finish a video in the background, it's the only way: it checks the storyboard and hands it to Agent Feed Cloud before it returns, and the video reaches your phone when it's ready.
--storyboard: The storyboard: @path/to/storyboard.json.--title: The video's title (default: the storyboard's).--project: The project folder the video is about (default: the current folder).--revise: The video this one revises (job_…, an answer on it, cmt_…, or its job folder): the new one is its next version.--share: Anyone with the link can watch it (videos start private).
Also:
--cloud: On a Mac, have Agent Feed Cloud make the video from it (invite-only during the beta). In CI it always does.
agentfeed auto
agentfeed auto [on|off]A video after each task the session finishes, what agents run when you ask for that (“make a video after every task”). When a turn that finished a task ends, Agent Feed's Stop hook has the agent write a brief and start the video in the background. Short turns, turns that already made a video and turns that answered your notes don't get one. It's per session and off by default; with neither on nor off, it says whether it's on. For an automation (a scheduled task, a claude -p or codex exec routine, cron or launchd), AGENTFEED_AUTO=1 in its environment does the same for the whole run, and a run with nothing to show gets no video. Codex runs the hook once you trust it in /hooks.
agentfeed share
agentfeed share job_...|JOB [--stop]Makes a video's link watchable by anyone who has it, and prints the link.
--stop: Make it private again: only you can watch it.
agentfeed delete
agentfeed delete job_...|JOB [--yes] [--json]Deletes a video from your Agent Feed account, from this Mac: its link stops working, and its comments go too. The video's folder on this Mac stays. At a terminal it asks first.
--yes: Don't ask first: for an agent or a script deleting it on your word.--json: Print the outcome as JSON (what Agent Feed for Mac reads).
agentfeed publish
agentfeed publish FILE.mp4 --title T [--poster FILE] [--captions FILE] [--share] [--revise JOB] [--json]Publishes a finished video made any way, and prints its link: no Manim, ffmpeg or voice key needed. Agent Feed measures it and makes its poster from the first frame. With ffmpeg here, a file iPhones can't play (H.264 in 4:4:4 color, ffmpeg's default from RGB sources; HEVC tagged hev1) is converted first. The answers come back to the session it runs in. Without a linked Mac, it signs in with the API key in AGENTFEED_API_KEY.
--title: Up to 120 characters.--poster: A JPEG shown before it plays. Without one, its first frame.--captions: WebVTT captions: each answer then comes with the line spoken at its moment.--share: Anyone with the link can watch it (default: only you, signed in).--revise: The video this one is the next version of: job_…, an answer on it (cmt_…) or a job folder.--json: Print the published video as JSON.
Also:
--agent: The agent that gets the answers, by a short lowercase name, e.g. cursor (default: this session's).--session: That agent's own session ID (default: this session's).--project: The folder whose name the feed shows (default: the current one).--thread: Add the video to one of this agent's threads, by its ID (thr_…, which make and publish print). A thread is one agent's videos on a theme, in order; the app shows them together.--new-thread: Start a thread of related videos with this title, the video its first.--no-thread: Publish it on its own, outside any thread. By default, a next version goes right after the one it revises, and any other video to this session's thread.--thread-avatar: A picture for the video's thread, which the iPhone app shows as the avatar of the thread's videos in place of the agent's: an https link to a square PNG or JPEG, 256 pixels or more. It stays for the thread's later videos; none takes it away. An automation gives its thread its source's mark this way.--agent-avatar: The picture your agent's avatar shows in the iPhone app, sent with the video: an https link to a square PNG or JPEG, or none for no picture. By default it's AGENTFEED_AGENT_AVATAR, else "agentAvatar" in ~/.agentfeed/settings.json, else Agent Feed's copy of the agent's maker's mark (Claude Code's, Codex's, Cursor's…).
agentfeed status
agentfeed status [JOB]Your background jobs, their state and their links; for one job, also what it cost to make.
Answers
Your answers from the phone: delivered into the agent's session, or read by the agent itself.
agentfeed inbox: The answers waiting for this session, each with the moment, the narration there and how to make the next version, marked read once shown.agentfeed serve: Delivers feedback and approvals from the Agent Feed app into the agent session that made each video.agentfeed serve --install: Feedback delivery in the background, which Agent Feed for Mac runs from login on.
agentfeed inbox
agentfeed inbox [--all] [--wait S] [--json]The answers waiting for this session, each with the moment, the narration there and how to make the next version, marked read once shown. Claude Code and Codex get theirs delivered on a signed-in Mac; every other agent, and an API key, reads them here.
--all: Every answer waiting for this Mac or API key, not only this session's.--wait: Seconds to hold for an answer when none is waiting (0–25).--json: Print the answers as JSON.
agentfeed serve
agentfeed serve [--once] [--wait S]Delivers feedback and approvals from the Agent Feed app into the agent session that made each video: its inbox when it's open, a background turn when it's closed, codex queue for Codex. Runs until stopped. Agent Feed for Mac runs it for you; while the app delivers, this says so and stops.
--once: Check the inbox once (waits for the background turns it starts).--wait: Seconds each poll may wait for new feedback (0–25).
agentfeed serve --install
agentfeed serve --install|--uninstall|--statusFeedback delivery in the background, which Agent Feed for Mac runs from login on. It also removes the LaunchAgent earlier versions installed.
--install: Open Agent Feed for Mac with delivery on, now and at every login.--uninstall: Turn the app's delivery off.--status: Who delivers feedback on this Mac: the app, a terminal, or nothing.
Step by step
Inline mode: an agent makes the video itself, one step at a time (the skill's reference/INLINE.md).
agentfeed new: Inline mode.agentfeed narrate: storyboard.json → narration.wav, words.json and timeline.json.agentfeed render: scene.py → out/final.mp4, 1080×1920 at 60 fps.agentfeed check: The quality verdict (voice, hook, pacing, layout, safe zones, loop), with keyframes.jpg and contact.jpg to look at.
agentfeed new
agentfeed new [--title T] [--dir PARENT]Inline mode: creates a job folder for a video the agent makes step by step, and prints its path.
--title: The video's title.--dir: Where to create the job folder (default ~/.agentfeed/jobs).
agentfeed narrate
agentfeed narrate JOB [--dry-run]storyboard.json → narration.wav, words.json and timeline.json: Seth's voice (your ElevenLabs key, or Agent Feed voice) and the 3b1b voice score.
--dry-run: Check the storyboard only; no voice is made.
agentfeed render
agentfeed render JOB [--preview]scene.py → out/final.mp4, 1080×1920 at 60 fps.
--preview: A fast, smaller draft (out/preview.mp4).
Also:
--scene: Render another scene file than JOB/scene.py.--class: The scene class to render (default: the file's first AgentFeedScene).
agentfeed check
agentfeed check JOB [--video FILE]The quality verdict (voice, hook, pacing, layout, safe zones, loop), with keyframes.jpg and contact.jpg to look at.
--video: Check another file than out/final.mp4.
For Agent Feed for Mac and the worker
Left out of agentfeed --help, but there to use: Agent Feed for Mac, the background worker and older sessions use them, and so can any agent.
agentfeed make --example: A bundled example whose storyboard and scene are already written, such as welcome.agentfeed videos: Your Agent Feed account's videos, newest first, including ones made on other Macs or in the cloud, and whether each was approved.agentfeed video: One video.agentfeed deliver: Sends “Video ready” to the session that asked for the video, again.agentfeed work: Runs a background job's worker in this terminal.agentfeed app: Opens Agent Feed for Mac, which shows the same videos as this command (both keep them in ~/.agentfeed) and delivers feedback from your phone.agentfeed crash-report: Sends Agent Feed for Mac's crash report to Agent Feed, as macOS wrote it but with your home folder written as ~.
agentfeed make --example
agentfeed make --example NAME [--project DIR] [--share]A bundled example whose storyboard and scene are already written, such as welcome: it's only narrated (with your voice choice), rendered and checked, so it takes minutes and no agent writes anything. Agent Feed for Mac makes your first video this way.
--example: The example's name, e.g. welcome.--project: The folder the video belongs to (default: the current folder).--share: Anyone with the link can watch it (videos start private).
agentfeed videos
agentfeed videos [--json] [--limit N]Your Agent Feed account's videos, newest first, including ones made on other Macs or in the cloud, and whether each was approved. Agent Feed for Mac reads this to show your whole history.
--json: Print JSON, the API's own shape (what Agent Feed for Mac reads).--limit: At most this many videos (1–500, default 50).
agentfeed video
agentfeed video job_...|JOB [--json]One video: its link, state, length and voice score, your comments with what happened to each, and its build steps.
--json: Print JSON: the video, its comments and its build events.
agentfeed deliver
agentfeed deliver JOBSends “Video ready” to the session that asked for the video, again.
agentfeed work
agentfeed work JOBRuns a background job's worker in this terminal: what make starts for you. A job that failed, or whose upload didn't finish, resumes this way; its message names the command.
agentfeed app
agentfeed appOpens Agent Feed for Mac, which shows the same videos as this command (both keep them in ~/.agentfeed) and delivers feedback from your phone.
agentfeed crash-report
agentfeed crash-report FILE [--show] [--json]Sends Agent Feed for Mac's crash report to Agent Feed, as macOS wrote it but with your home folder written as ~. Agent Feed for Mac runs it only when you said yes; nothing is sent with only this Mac.
--show: Print exactly what would be sent, and send nothing.--json: Print the outcome as JSON (what Agent Feed for Mac reads).