README.md

# Riverside Plugin for Claude Code, Cursor, ChatGPT, and Codex

Search your recordings by what you said in them, edit your videos, and publish clips to social media — all from Claude Code, Cursor, ChatGPT, or Codex.

## Installation

```text
/plugin install riverside
```

In Claude Code, the first tool call asks you to connect your Riverside account through a browser (one-time OAuth). A qualifying paid plan is required — Free and Pro accounts can't use the MCP.

## Cursor

Riverside is also packaged for the Cursor marketplace (`.cursor-plugin/plugin.json`). Once listed, install it from Cursor's plugin marketplace by searching "Riverside." To try it locally before that listing goes live, see [`docs/cursor-testing.md`](docs/cursor-testing.md).

## ChatGPT and Codex

Riverside is packaged for ChatGPT and Codex too (`.codex-plugin/plugin.json`), sharing the same five skills.

Install Riverside from the host's plugin directory and connect your Riverside
account. The plugin supplies workflow skills and the authenticated MCP connection
supplies tools. Each client connects separately. See the [`setup`](skills/setup/SKILL.md)
skill and [current connection guide](https://support.riverside.com/hc/en-us/articles/37803607978141-Connect-to-Riverside-MCP).

For a manual connection, use `https://mcp.riverside.com/mcp` with OAuth in the
host's current plugin or connector settings. Codex also supports
`codex mcp add riverside --url https://mcp.riverside.com/mcp`, followed by
`codex mcp login riverside`. ChatGPT workspace settings determine write access.

## What You Can Do

### Search and Content Discovery

Search across your archive by spoken content or title, and navigate your
productions, studios, projects, recordings, edits, and transcripts.

- "Find the episode where I talked about fundraising"
- "Which recordings mention our Series A?"
- "Send me the download link for yesterday's recording"
- "List the recordings in my podcast studio"

### Video Editing

Turn recordings into edits, then cut, clean up, caption, lay out, and brand them.

- "Turn yesterday's recording into an edit and remove the filler words"
- "Cut this down to the part where we talk about pricing and add captions"
- "Apply my studio's brand kit to this edit"

### Social Publishing

Publish or schedule clips to YouTube, TikTok, Instagram, Facebook, LinkedIn, and X.

- "Post my latest clip to TikTok"
- "Schedule my interview highlights to YouTube Shorts for tomorrow at 9am"
- "Share this clip on LinkedIn"

### Podcast Hosting

Browse hosted shows and episodes, create or update podcast metadata, replace
artwork, connect distribution destinations, and read download analytics.

- "List my hosted podcasts and their latest episodes"
- "Prepare a podcast episode from this recording"
- "Show downloads for my podcast over the last month"

Podcast hosting uses the same Riverside connection. Publishing and distribution
follow the current hosting prerequisites and the user's confirmed choices.

## Requirements

- A [Riverside](https://riverside.com) account on a qualifying paid plan — Free and Pro accounts can't use the MCP
- A supported client: Claude Code (CLI, desktop, or IDE extension), Cursor, ChatGPT, or Codex

## Authentication

In Claude Code and Cursor, the first Riverside tool call starts the OAuth flow;
the client discovers Riverside's authorization server automatically. In ChatGPT
and Codex, connect before the first tool call using the steps above. ChatGPT
opens sign-in while creating or connecting Riverside, and Codex starts it with
`codex mcp login riverside`; neither waits for a first-tool-call prompt.

In every host, `https://riverside.com/auth` is the OAuth issuer identifier, not a
page to visit. The client opens Riverside's hosted sign-in in your browser, and
the prompt asking whether to grant the client access belongs to your client, not
to Riverside. Sign in and approve access; no API key is required.

A connection currently lasts **7 days**. There is no silent token refresh, so
when it expires — or if you revoke it — reconnect from the host's connection
settings or CLI and complete the browser flow again.

## Support & Security

- **Support:** the [Riverside Help Center](https://support.riverside.com/hc/en-us)
  for account, billing, or product questions. Connection steps for each client
  are in [Connect to Riverside MCP](https://support.riverside.com/hc/en-us/articles/37803607978141-Connect-to-Riverside-MCP).
- **Security vulnerability reports:** email
  [security@riverside.fm](mailto:security@riverside.fm). Please do not file
  security issues as public GitHub issues.

## Privacy

Riverside's privacy policy applies to any data accessed through this plugin:
[https://riverside.com/privacy-policy](https://riverside.com/privacy-policy)

Use of the Riverside service is governed by its terms and conditions:
[https://riverside.com/terms-conditions](https://riverside.com/terms-conditions)

## License

MIT — see [LICENSE](LICENSE).