# Quickstart

From install to your first answered video, in five steps.

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

```bash
claude plugin marketplace add Agent-Feed/agentfeed
claude plugin install agentfeed@agentfeed
```

Then type `/reload-plugins` in the session.

In Codex:

```bash
codex plugin marketplace add Agent-Feed/agentfeed
codex plugin add agentfeed@agentfeed
```

Then 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:

```bash
agentfeed setup
```

It 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:

```bash
brew install ffmpeg cairo pkgconf
```

## 3. 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:

```bash
agentfeed login
```

It 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.

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

## 4. 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.

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

```bash
agentfeed serve
```

The agent makes the change, and answers with version 2 of the video. It lands in your feed like any other.

## Next

- [How it works](https://agentfeed.com/docs/how-it-works.md): what happens between the brief and your feed.
- [Get answers back](https://agentfeed.com/docs/publish/answers.md): what the agent receives, and when.
- [Troubleshooting](https://agentfeed.com/docs/help/troubleshooting.md): when a step doesn't work.

---

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