# Install Agent Feed

Agent Feed turns a coding agent's finished work into short narrated videos that the person watches on their phone, and brings their answers back into the session that made each video. It runs on a Mac, in a private beta: installing needs an invitation.

These steps are for you, the agent, as much as for a person typing them by hand. Run each one yourself, and leave to the person only what needs them: signing in to GitHub, reloading plugins or starting a new session, the iPhone app and approving the link, keeping `agentfeed serve` open, and typing their own keys. The steps are safe to follow again: skip what's already done.

Follow the section for the agent you are:

- Claude Code
- Codex
- Any agent with a terminal
- Chat apps (MCP)

## Claude Code

Agent Feed's plugin gives Claude Code the video skill and the `agentfeed` command, on a Mac.

### 1. Add the plugin

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

During the private beta, the plugin's repository (`Agent-Feed/agentfeed` on GitHub) is private: adding it needs a GitHub account with an invitation, and git on this Mac signed in to GitHub. If it fails (`Failed to clone marketplace repository`, then `Permission denied (publickey)` or another sign-in error), check with `git ls-remote https://github.com/Agent-Feed/agentfeed`. If git isn't signed in, sign in with `gh auth login`, then run `gh auth setup-git` and add the marketplace again. With no invitation yet, join the beta at agentfeed.com, and stop here.

### 2. Load it

A plugin added during a session loads in the next one: type `/reload-plugins` in Claude Code, then carry on here.

### 3. Set it up

The Agent Feed skill is loaded now. From its folder, run:

```bash
scripts/agentfeed setup
```

The folder is in the plugin's copy: `~/.claude/plugins/cache/agentfeed/agentfeed/<version>/skills/agentfeed-video`.

Setup asks nothing, and takes about a minute the first time. It ends with `agentfeed doctor`'s report: run the fix each line names. If Homebrew's ffmpeg or cairo is missing, that's `brew install ffmpeg cairo pkgconf`, then setup again. Two fixes are the person's: `agentfeed login`, in the next step, and the narration voice. That's Agent Feed voice if their account is in its beta, or else their own ElevenLabs key, which they store with `agentfeed setup --key` and type themselves. Doctor's narration voice line says which applies.

### 4. Sign in to Agent Feed

Install Agent Feed for iPhone from your TestFlight invitation, and sign in with your phone number. Then, on your Mac:

```bash
agentfeed login
```

It opens Agent Feed's sign-in in your browser: sign in with the same phone number, and each video then gets a link that plays on your phone. An agent that runs it says just that, and never repeats a code or a link from its output.

### 5. Turn on answers

Your answers come back only while `agentfeed serve` runs on this Mac. Start it in a terminal, and leave the terminal open:

```bash
agentfeed serve
```

With Agent Feed for Mac (in a private beta of its own), the app runs it for you from every login: `agentfeed serve --install` turns that on. `agentfeed serve --status` says what's delivering your answers.

### 6. Make your first video

Agent Feed is ready. Ask your agent: "Make an Agent Feed video of what you just did." It replies with the video's link at once, and the video is ready about 15 to 30 minutes later.

### What gets installed

- The Agent Feed plugin, from the `Agent-Feed/agentfeed` marketplace: the video skill, and a Stop hook that stays quiet until you ask for a video after every task.
- The video toolkit: its own Python with Manim, in `~/.agentfeed/venv`, and the `agentfeed` command, in `~/.local/bin`.
- Homebrew's ffmpeg, cairo and pkgconf, if they were missing.
- Once you sign in, this Mac's token, in the macOS Keychain.

### How answers come back

Your answers, spoken or typed at a moment in the video, go back into the Claude Code session that made it: right away when it's open, or in a background turn when it's closed. The agent acts on them, and makes version 2 of the video when one asks for a change.

They come back only while `agentfeed serve` runs on your Mac (step 5). A session in Bypass permissions holds messages from outside it, and Claude Code's desktop app drops them after five minutes: `agentfeed setup --wake-sessions` lets them through.

## Codex

Agent Feed's plugin gives Codex the video skill and the `agentfeed` command, on a Mac.

### 1. Add the plugin

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

During the private beta, the plugin's repository (`Agent-Feed/agentfeed` on GitHub) is private: adding it needs a GitHub account with an invitation, and git on this Mac signed in to GitHub. If it fails (`Failed to clone marketplace repository`, then `Permission denied (publickey)` or another sign-in error), check with `git ls-remote https://github.com/Agent-Feed/agentfeed`. If git isn't signed in, sign in with `gh auth login`, then run `gh auth setup-git` and add the marketplace again. With no invitation yet, join the beta at agentfeed.com, and stop here.

### 2. Load it

A plugin added during a session loads in the next one: start a new Codex session. If your agent is installing, say "Install Agent Feed: agentfeed.com/install" in the new session, and it carries on from step 3.

### 3. Set it up

The Agent Feed skill is loaded now. From its folder, run:

```bash
scripts/agentfeed setup
```

The folder is in the plugin's copy: `~/.codex/plugins/cache/agentfeed/agentfeed/<version>/skills/agentfeed-video`.

Setup asks nothing, and takes about a minute the first time. It ends with `agentfeed doctor`'s report: run the fix each line names. If Homebrew's ffmpeg or cairo is missing, that's `brew install ffmpeg cairo pkgconf`, then setup again. Two fixes are the person's: `agentfeed login`, in the next step, and the narration voice. That's Agent Feed voice if their account is in its beta, or else their own ElevenLabs key, which they store with `agentfeed setup --key` and type themselves. Doctor's narration voice line says which applies.

### 4. Sign in to Agent Feed

Install Agent Feed for iPhone from your TestFlight invitation, and sign in with your phone number. Then, on your Mac:

```bash
agentfeed login
```

It opens Agent Feed's sign-in in your browser: sign in with the same phone number, and each video then gets a link that plays on your phone. An agent that runs it says just that, and never repeats a code or a link from its output.

### 5. Turn on answers

Your answers come back only while `agentfeed serve` runs on this Mac. Start it in a terminal, and leave the terminal open:

```bash
agentfeed serve
```

With Agent Feed for Mac (in a private beta of its own), the app runs it for you from every login: `agentfeed serve --install` turns that on. `agentfeed serve --status` says what's delivering your answers.

### 6. Make your first video

Agent Feed is ready. Ask your agent: "Make an Agent Feed video of what you just did." It replies with the video's link at once, and the video is ready about 15 to 30 minutes later.

### What gets installed

- The Agent Feed plugin, from the `Agent-Feed/agentfeed` marketplace: the video skill, and a Stop hook that runs once you trust it in `/hooks`, and only when you ask for a video after every task.
- The video toolkit: its own Python with Manim, in `~/.agentfeed/venv`, and the `agentfeed` command, in `~/.local/bin`.
- Homebrew's ffmpeg, cairo and pkgconf, if they were missing.
- Once you sign in, this Mac's token, in the macOS Keychain.

### How answers come back

Your answers, spoken or typed at a moment in the video, go back into the Codex thread that made it, through its queue (`codex queue`). The agent acts on them, and makes version 2 of the video when one asks for a change.

They come back only while `agentfeed serve` runs on your Mac (step 5).

## Any agent with a terminal

For another agent that can run commands on your Mac. It gets the skill and the `agentfeed` command, and Claude Code or Codex, on the same Mac, makes the videos it asks for.

### 1. Get the toolkit

```bash
git clone https://github.com/Agent-Feed/agentfeed ~/agentfeed
~/agentfeed/plugin/skills/agentfeed-video/scripts/agentfeed setup
```

During the private beta, the repository is private: cloning it needs a GitHub account with an invitation, and git on this Mac signed in to GitHub (`gh auth login`, then `gh auth setup-git`). With no invitation yet, join the beta at agentfeed.com, and stop here.

Setup links the skill into `~/.agents/skills` and `~/.claude/skills`, where many agents look for skills. If yours looks elsewhere, point it at `~/agentfeed/plugin/skills/agentfeed-video/SKILL.md`.

Setup asks nothing, and takes about a minute the first time. It ends with `agentfeed doctor`'s report: run the fix each line names. If Homebrew's ffmpeg or cairo is missing, that's `brew install ffmpeg cairo pkgconf`, then setup again. Two fixes are the person's: `agentfeed login`, in the next step, and the narration voice. That's Agent Feed voice if their account is in its beta, or else their own ElevenLabs key, which they store with `agentfeed setup --key` and type themselves. Doctor's narration voice line says which applies.

### 2. Sign in to Agent Feed

Install Agent Feed for iPhone from your TestFlight invitation, and sign in with your phone number. Then, on your Mac:

```bash
agentfeed login
```

It opens Agent Feed's sign-in in your browser: sign in with the same phone number, and each video then gets a link that plays on your phone. An agent that runs it says just that, and never repeats a code or a link from its output.

### 3. Make your first video

Write a short brief of what the video should explain, then run:

```bash
agentfeed make --brief @brief.md --project . --title "What I just did"
```

It prints the video's link at once. Claude Code or Codex on this Mac makes the video in the background, so one of them must be installed and signed in. It's ready about 15 to 30 minutes later: `agentfeed status` shows how it's going.

### What gets installed

- A copy of the `Agent-Feed/agentfeed` repository, in `~/agentfeed`.
- The video toolkit: its own Python with Manim, in `~/.agentfeed/venv`, and the `agentfeed` command, in `~/.local/bin`.
- Links to the skill, in `~/.agents/skills` and `~/.claude/skills`.
- Homebrew's ffmpeg, cairo and pkgconf, if they were missing.
- Once you sign in, this Mac's token, in the macOS Keychain.

### How answers come back

Not into this agent's session yet: `agentfeed serve` delivers answers only into Claude Code and Codex sessions. Your agent reads them when it asks:

```bash
agentfeed videos
agentfeed video job_…
```

The first lists your videos. The second shows one video's comments, and what happened to each.

## Chat apps (MCP)

Agent Feed's MCP server, at `https://api.agentfeed.com/mcp`, lets an agent publish a video it made, list your videos, read your answers, share a video, and, on the Cloud plan (not open yet), ask Agent Feed Cloud for a new one. An app that signs in to MCP servers with OAuth connects with just that address: you approve it in your browser, and it acts on the videos it publishes. An agent on a Mac that's signed in to Agent Feed can sign in as the Mac instead, with these steps.

### 1. Sign in on a Mac

Install Agent Feed in Claude Code or Codex on your Mac first, with their steps here. Its `agentfeed login` signs the Mac in, and the server signs in as that Mac.

### 2. Add the server to Claude Code

```bash
claude mcp add --transport http agentfeed https://api.agentfeed.com/mcp --header "Authorization: Bearer $(security find-generic-password -s agentfeed-device -a https://api.agentfeed.com -w)"
```

It reads this Mac's token from the Keychain. Claude Code keeps the token in its MCP settings, so treat that configuration as a secret: anyone who has it can use Agent Feed as this Mac.

### What gets installed

- Nothing new on your Mac: Claude Code's MCP settings keep the server's address and this Mac's token.

### How answers come back

The agent reads them when it asks: `list_feedback` returns your answers on the videos it published or asked for (with `all_videos`, on your other videos too), and marks them read in the app. Nothing else needs to run on your Mac.
