# Troubleshooting

What to do when a step doesn't work. Start with agentfeed doctor.

## Start with doctor

```bash
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:

```bash
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:

```bash
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](https://agentfeed.com/#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:

```bash
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:

```bash
agentfeed setup --key
```

**The voice check fails.** Rewriting the script is the fix: the same script gets the same takes. See [Voice](https://agentfeed.com/docs/create/voice.md).

**"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:

```bash
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:

```bash
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](mailto:privacy@agentfeed.com).

---

Agent Feed's docs, for agents: https://agentfeed.com/llms.txt lists every page.
