BitterClip for agents

Turn a recording into a finished clip by describing what you want.

BitterClip · Install · Agent guide · Product docs · Agent-readable docs · Support

BitterClip gives Claude, Codex, and other compatible agents the context and tools to make real video edits. Tell the agent the story you want to tell. It finds supported moments in your Recording, makes a purposeful first cut, and returns an editable Clip with an exact playable and downloadable Export.

Then keep talking:

Make a concise clip about why customer interviews changed our roadmap. Keep the opening direct and make it work in portrait.

The opening still takes too long. Start with the strongest claim and keep the customer's explanation intact.

That feedback revises the same Clip. The earlier Export stays intact, and the new Download belongs to the new revision.

Install the pilot plugin

You need a BitterClip account with an uploaded, ready Recording and a host that supports one of the install routes below. This package does not include a free hosted-service entitlement.

For Claude web, download the v0.1.3 Claude ZIP and upload it at Customize → Plugins → Add plugin → Upload plugin. No source build is needed. The GitHub pilot prerelease also includes the portable Agent Plugins ZIP and release identity record.

Build from source

For Claude Code or a local portable marketplace, start with the source checkout:

git clone https://github.com/sheetgenius/bitterclip-plugin.git
cd bitterclip-plugin
npm ci
npm test
npm run verify

For Claude Code, install the generated local marketplace:

claude plugin marketplace add ./dist/claude
claude plugin install bitterclip@bitterclip

You can also upload the locally built dist/archives/bitterclip-0.1.3-claude-plugin.zip to Claude web.

For Codex, use the unpacked portable package at dist/portable/bitterclip through the documented local marketplace route. The Agent Plugins ZIP is a release artifact, not a claimed universal import flow. See Installation.

Your host handles BitterClip sign-in over OAuth. There are no API keys to paste into the package.

What the agent does

Recording
  → understand the relevant material
  → choose source-supported moments
  → make one editable Clip
  → render one exact Export
  → take creative feedback
  → improve the same Clip

You provide the intent and the creative correction. The agent handles source search, media inspection, timing evidence, edit sequencing, rendering, and recovery. You should not need to supply timestamps or choreograph tools.

The package includes three focused skills:

• get-started finds a ready Episode or helps continue a first upload.
• make-a-clip creates or revises a source-backed Clip.
• review-and-export binds review, playback, and Download to the exact current Export.

See the Agent guide for good requests and the full working contract.

What changes, and what stays true

You ask for	BitterClip changes	BitterClip preserves
A first cut	A new editable Clip and, unless you ask for draft-only, a private Export	The original Recording and its source timing
A correction	The same Clip gets a new revision and, when finished-result intent remains, a new exact Export	Earlier Exports, source lineage, and draft-only intent
Review only	Nothing unless you ask for an edit	The current Clip, Export, and permissions
Publishing	A review handoff is prepared	Nothing is dispatched without the exact Export, destination, and fresh confirmation

What this repository contains

This is an open-source integration package: skills plus configuration for the hosted BitterClip OAuth MCP service at https://app.bitterclip.com/mcp. It does not contain the hosted BitterClip application, customer media, credentials, a local MCP server, or a free hosted-service entitlement.

BitterClip is a product of SheetGenius, Inc.. Learn about the product on the website, read the assistant overview, give an agent the plain-text product map, or see current plans in the homepage pricing section.

Host support

Current as of 2026-09-12:

Host	Package path	Current evidence
Claude web	Generated Claude ZIP	Private 0.1.2 install showed all three skills and the existing connected BitterClip connector; an explicit get-started invocation ran.
Claude Code	Generated local marketplace	Isolated install checked with Claude Code 2.1.269.
Codex / ChatGPT desktop	Portable Agent Plugins package through a local or repo marketplace	The package follows the documented portable schema; a fresh BitterClip install and automatic skill-discovery journey have not yet been run.
ChatGPT connector	Hosted MCP connection	Connector use is separate from installing the three packaged skills; no public BitterClip plugin listing is claimed.

The new 0.1.3 candidate is a docs, metadata, and licensing release with the same three skills as 0.1.2. It has not replaced the privately installed 0.1.2 candidate. See Installation for the exact boundary.

Build and verify

Requirements: a current Node.js/npm environment and, for native validation, the Claude CLI.

npm ci
npm test
npm run verify

npm run verify builds:

• dist/archives/bitterclip-0.1.3-claude-plugin.zip
• dist/archives/bitterclip-0.1.3-agent-plugin.zip
• dist/claude, the local Claude marketplace
• dist/portable/bitterclip, the unpacked portable package

Validation proves package structure and reproducibility. A useful result still ends with a human watching and, when audio matters, listening to the exact Export.

Contributing and trust

Start with CONTRIBUTING.md. Please report vulnerabilities privately as described in SECURITY.md. The package is MIT licensed; vendored schema and dependency terms are recorded in THIRD_PARTY_NOTICES.md. BitterClip names and marks are covered by TRADEMARKS.md.

For help with the product or connection, visit BitterClip Support or email hello@bitterclip.com. See the privacy policy before connecting an account.