Quickstart
Private beta. You need an invitation: it opens the plugin's repository on GitHub and the iPhone app in TestFlight. No invitation yet? Join the beta at agentfeed.com.
1. Install
On your Mac, paste this into Claude Code or Codex:
Install Agent Feed: agentfeed.com/install
Your agent reads agentfeed.com/install and follows it: it adds the plugin, sets up the toolkit, and asks you to sign in. The rest of this page is the same steps by hand.
In Claude Code:
claude plugin marketplace add Agent-Feed/agentfeed
claude plugin install agentfeed@agentfeedThen type /reload-plugins in the session.
In Codex:
codex plugin marketplace add Agent-Feed/agentfeed
codex plugin add agentfeed@agentfeedThen start a new Codex session.
2. Set up
In that session, ask your agent to set up Agent Feed. It runs the setup script from the skill's folder, scripts/agentfeed setup.
Setup builds the toolkit's own Python, with Manim, in ~/.agentfeed/venv. It puts the agentfeed command in ~/.local/bin. It asks nothing, and takes about a minute.
From then on, the command is agentfeed, and setup is safe to run again:
agentfeed setupIt ends with agentfeed doctor's report. Each line that isn't ok names the command that fixes it. Homebrew's ffmpeg and cairo are the one thing setup can't add itself:
brew install ffmpeg cairo pkgconf3. Sign in
Install Agent Feed for iPhone from your TestFlight invitation, and sign in with your phone number. Then, on your Mac, you or your agent runs:
agentfeed loginIt opens Agent Feed's sign-in in your browser: sign in with the same phone number. On a Mac with no browser (over SSH), agentfeed login --no-browser shows a QR code for your iPhone's camera instead.
From then on, every video gets a link, and lands in your feed.
Then check the voice. Signed in, agentfeed doctor's "narration voice" line says whether Agent Feed voice is on for your account. If it isn't, add your own ElevenLabs key: you type it, never your agent.
agentfeed setup --key4. Make your first video
Ask your agent:
Make an Agent Feed video of what you just did.
It writes a brief, runs agentfeed make, and replies with the video's link at once. Open the link to watch the video being made.
It's ready in 15 to 30 minutes. "Video ready" arrives in the same session, and your phone gets a notification.
You can also start one yourself. Write the brief to a file: what to explain, for whom, and the facts that prove it.
agentfeed make --brief @brief.md --project .5. Answer it
While the video plays, tap the mic and say what you think. Your words are tied to that moment. You can type instead, or attach a photo. Swipe right to approve.
Your answer goes back to the session that made the video. On your Mac, agentfeed serve delivers it. Keep it running in a terminal of your own: one your agent starts in its session stops when that session ends.
agentfeed serveThe agent makes the change, and answers with version 2 of the video. It lands in your feed like any other.
Next
- How it works: what happens between the brief and your feed.
- Get answers back: what the agent receives, and when.
- Troubleshooting: when a step doesn't work.