Troubleshooting

Start with doctor

agentfeed doctor

It checks ffmpeg, cairo, Manim, the narration voice, Claude Code and Codex, how videos are made, the agentfeed command, this Mac's link, and who delivers your answers. Each line that isn't ok names the command that fixes it.

It exits with 1 when something a video needs is missing: ffmpeg, cairo, Manim, a voice, or the command itself.

Installing

"Failed to clone marketplace repository", then "Permission denied (publickey)". During the beta, the plugin's repository is private. Your GitHub account needs the invitation, and git must be signed in to GitHub:

gh auth login
gh auth setup-git

Then add the marketplace again. Check access with git ls-remote https://github.com/Agent-Feed/agentfeed.

"agentfeed: command not found". Setup puts it in ~/.local/bin. Run setup from the skill's folder (scripts/agentfeed setup), and add ~/.local/bin to your PATH if setup says it isn't there.

"Missing system packages". Setup needs Homebrew's ffmpeg, cairo and pkgconf:

brew install ffmpeg cairo pkgconf
agentfeed setup

Signing in

"You're on the waitlist". Agent Feed is in a private beta, and an invitation gives your account access. Open your invitation's link, or join the beta at agentfeed.com.

"The sign-in timed out", "This sign-in has ended" or "This code has expired". A sign-in lasts ten minutes. Run agentfeed login again.

"This Mac was signed out of Agent Feed". It was signed out under Signed-in Macs, or the account's data was deleted. Run agentfeed login to sign in again.

Making a video

"The brief is too short". A brief needs at least 15 words. Write what to explain, for whom, and the facts that prove it: 150 to 400 words is best.

No link. "This video stays on this Mac (no link)" means this Mac isn't signed in. Run agentfeed login, and the next video gets a link.

"Video job failed". The message names the log, worker.log in the job folder, and the command that runs the job again:

agentfeed work <job folder>

"Agent Feed voice isn't on for this account yet". Agent Feed voice is invite-only during the beta. Add your own ElevenLabs key instead:

agentfeed setup --key

The voice check fails. Rewriting the script is the fix: the same script gets the same takes. See Voice.

"Agent Feed Cloud didn't take it". Cloud is invite-only during the beta, and has a monthly allowance. The video is made on your Mac instead.

Your answers

Your phone shows "Sent", and nothing more. Your Mac hasn't picked it up yet. Check that something delivers on your Mac:

agentfeed serve --status

If nothing does, run agentfeed serve in a terminal and keep it running.

"Couldn't reach Claude Code". The note shows why:

  • the session is open in a window that can't take messages from Agent Feed;
  • the session was waiting for your answer to its own question for six hours;
  • the session is in Bypass permissions, which holds messages from outside it. Let them through, once:
agentfeed setup --wake-sessions

Answers on a video from CI. They stay on the video: the run's session is gone, so no agent picks them up.

Still stuck

During the beta, send feedback from TestFlight. For anything about your data, write to privacy@agentfeed.com.