|
| 1 | +--- |
| 2 | +title: "Install the HyperFrames plugin" |
| 3 | +sidebarTitle: "Agent plugins" |
| 4 | +description: "Install video creation skills as one versioned plugin and let your agent manage updates." |
| 5 | +--- |
| 6 | + |
| 7 | +The HyperFrames plugin gives your coding agent the complete set of video workflows: |
| 8 | +product promos, explainers, captions, motion graphics, and more. Skills load when |
| 9 | +needed; you do not have to install each workflow separately. |
| 10 | + |
| 11 | +Choose one installation method per agent. Plugins receive updates through the |
| 12 | +agent's plugin manager. [Standalone skills](/guides/skills) remain available for |
| 13 | +OpenCode and other agents, or when you prefer the smaller core-only install. |
| 14 | + |
| 15 | +| Agent | Installation route | |
| 16 | +| --- | --- | |
| 17 | +| Claude Code | HyperFrames' GitHub marketplace | |
| 18 | +| Copilot CLI | HyperFrames' GitHub marketplace | |
| 19 | +| VS Code / Copilot | Add the GitHub marketplace in the Extensions view | |
| 20 | +| Cursor | Import through a team marketplace, or load a local plugin | |
| 21 | +| Gemini CLI | Install the HyperFrames extension from GitHub | |
| 22 | +| Codex | Use your existing HyperFrames plugin; directory updates are published separately | |
| 23 | +| OpenCode | Use standalone skills | |
| 24 | + |
| 25 | +You need Node.js 22+ and npm for the local CLI, plus FFmpeg for rendering. |
| 26 | +Install on each machine you use; a plugin does not synchronize your machines. |
| 27 | + |
| 28 | +## Claude Code |
| 29 | + |
| 30 | +Run in your terminal: |
| 31 | + |
| 32 | +```bash |
| 33 | +claude plugin marketplace add heygen-com/hyperframes |
| 34 | +claude plugin install hyperframes@hyperframes |
| 35 | +claude plugin details hyperframes |
| 36 | +``` |
| 37 | + |
| 38 | +The inventory should include `hyperframes`, `general-video`, and `media-use`. |
| 39 | +Start a new session or run `/reload-plugins`, then try: |
| 40 | + |
| 41 | +```text |
| 42 | +Using /hyperframes:hyperframes, make a 5-second title card that says "Hello world". |
| 43 | +``` |
| 44 | + |
| 45 | +**Enable automatic updates:** run `/plugin`, open **Marketplaces**, select |
| 46 | +**hyperframes**, and choose **Enable auto-update**. Third-party marketplaces do |
| 47 | +not enable this by default. To update manually: |
| 48 | + |
| 49 | +```bash |
| 50 | +claude plugin update hyperframes@hyperframes |
| 51 | +``` |
| 52 | + |
| 53 | +Reload plugins after updating. To remove the plugin: |
| 54 | + |
| 55 | +```bash |
| 56 | +claude plugin uninstall hyperframes@hyperframes |
| 57 | +``` |
| 58 | + |
| 59 | +See [Claude's plugin guide](https://code.claude.com/docs/en/plugins/install) |
| 60 | +for project-wide installation and managed update policies. |
| 61 | + |
| 62 | +## GitHub Copilot CLI |
| 63 | + |
| 64 | +```bash |
| 65 | +copilot plugin marketplace add heygen-com/hyperframes |
| 66 | +copilot plugin install hyperframes@hyperframes |
| 67 | +copilot plugin list |
| 68 | +``` |
| 69 | + |
| 70 | +Start a fresh session and ask Copilot to use the HyperFrames skill to make the |
| 71 | +same title card. Check `/skills list` if the skill is not visible. |
| 72 | + |
| 73 | +```bash |
| 74 | +copilot plugin update hyperframes |
| 75 | +copilot plugin uninstall hyperframes |
| 76 | +``` |
| 77 | + |
| 78 | +These are explicit updates; do not assume Copilot CLI shares VS Code's update |
| 79 | +schedule. See [Copilot's plugin guide](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing). |
| 80 | + |
| 81 | +## VS Code |
| 82 | + |
| 83 | +Open the Extensions view and search `@agentPlugins`. Add |
| 84 | +`heygen-com/hyperframes` as a marketplace using the plugin marketplace command, |
| 85 | +then install **hyperframes** and verify its skills in Agent Customizations. |
| 86 | +Agent plugins must be enabled in VS Code settings. |
| 87 | + |
| 88 | +VS Code checks for updates every 24 hours when `extensions.autoUpdate` is enabled. |
| 89 | +Use **Extensions: Check for Extension Updates** for a manual check. Disable or |
| 90 | +uninstall the plugin from the Extensions view. See [VS Code's plugin guide](https://code.visualstudio.com/docs/agent-customization/agent-plugins) |
| 91 | +for the current UI and workspace recommendations. |
| 92 | + |
| 93 | +## Cursor |
| 94 | + |
| 95 | +For a team marketplace, import `heygen-com/hyperframes` in **Dashboard → Plugins & |
| 96 | +MCPs** and add the HyperFrames plugin. Teammates install it from **Customize**. |
| 97 | +GitHub marketplace auto-refresh requires the Cursor GitHub App and the marketplace's |
| 98 | +**Enable Auto Refresh** setting. |
| 99 | + |
| 100 | +For a local install, copy an extracted HyperFrames plugin folder to |
| 101 | +`~/.cursor/plugins/local/hyperframes`, then reload Cursor and check **Customize**. |
| 102 | +The folder must contain `plugin.json` and `skills/`. Local copies require manual |
| 103 | +replacement to update; they do not subscribe to GitHub changes. Enterprise policy |
| 104 | +may disable local plugin imports. Remove the local folder to uninstall that copy. |
| 105 | + |
| 106 | +This repository's manifests are not proof of a public Cursor marketplace listing. |
| 107 | +Public listings and their updates go through Cursor review. See [Cursor's plugin |
| 108 | +guide](https://cursor.com/docs/plugins) for marketplace and local-install controls. |
| 109 | + |
| 110 | +## Gemini CLI |
| 111 | + |
| 112 | +```bash |
| 113 | +gemini extensions install https://github.com/heygen-com/hyperframes --auto-update |
| 114 | +gemini extensions list |
| 115 | +``` |
| 116 | + |
| 117 | +Restart Gemini CLI and ask it to use the HyperFrames skill for the title card. |
| 118 | +To manage the extension explicitly: |
| 119 | + |
| 120 | +```bash |
| 121 | +gemini extensions update hyperframes |
| 122 | +gemini extensions uninstall hyperframes |
| 123 | +``` |
| 124 | + |
| 125 | +To stay on a specific release, install with `--ref <release-tag>` instead of |
| 126 | +`--auto-update`. Choose a release containing `gemini-extension.json`. |
| 127 | +See [Gemini's extension guide](https://geminicli.com/docs/extensions/reference/). |
| 128 | + |
| 129 | +The embedded-captions workflow additionally needs project-local Sharp, Puppeteer |
| 130 | +with Chromium, and GSAP. Its skill includes the versioned installation command; |
| 131 | +keep those dependencies and their lockfile in the caption project. The plugin |
| 132 | +itself remains read-only and does not include browsers or model weights. |
| 133 | + |
| 134 | +## Versions and updates |
| 135 | + |
| 136 | +The plugin bundles workflows from one source snapshot and runs the CLI version |
| 137 | +recorded in its manifest. Your agent should use its bundled plugin launcher; |
| 138 | +it should not run `npx hyperframes skills update` during a plugin workflow. |
| 139 | +Existing project dependencies, downloaded media, and external services have their |
| 140 | +own versions and are not frozen by the plugin. |
| 141 | + |
| 142 | +Update behavior depends on the client and source ref. For example, |
| 143 | +[Cursor GitHub Auto Refresh](https://cursor.com/docs/plugins#keep-plugins-up-to-date) |
| 144 | +follows pushes to the tracked branch, so skill content can change without a new |
| 145 | +CLI version. The manifest pins the CLI version, not the installed skill commit. |
| 146 | +For a repeatable installation, keep a release tag or an extracted release archive |
| 147 | +and disable automatic updates. Install that same release on each machine. |
| 148 | +Git-based installs may download the full source repository. Release ZIPs contain |
| 149 | +only the plugin payload, but loading an extracted ZIP locally requires manual updates. |
| 150 | +Only releases with a `hyperframes-agent-plugin.zip` asset provide that portable ZIP. |
| 151 | + |
| 152 | +## Move from standalone skills or core-skills |
| 153 | + |
| 154 | +Install the full plugin and verify its inventory first. In Claude, an older |
| 155 | +`core-skills@hyperframes` install can then be removed: |
| 156 | + |
| 157 | +```bash |
| 158 | +claude plugin uninstall core-skills@hyperframes |
| 159 | +``` |
| 160 | + |
| 161 | +Use your standalone skill manager to remove only the old HyperFrames skills for |
| 162 | +that agent. Inspect the locations first: other agents may share a global skills |
| 163 | +store, and locally edited skills should be backed up. Do not delete an entire |
| 164 | +`.agents` or `.claude` directory. Restart the agent and confirm it selects the |
| 165 | +plugin copy rather than a duplicate standalone skill. |
| 166 | + |
| 167 | +## If a workflow is missing or stale |
| 168 | + |
| 169 | +1. Check the agent's installed plugin inventory and version. |
| 170 | +2. Update using that agent's plugin manager, then reload or restart it. |
| 171 | +3. Check whether an old standalone installation is also being loaded. |
| 172 | +4. For a pinned release, verify the workflow exists in that release. Do not mix |
| 173 | + skills from a newer release into the plugin folder. |
| 174 | + |
| 175 | +## Related topics |
| 176 | + |
| 177 | +- [Make your first video](/quickstart) |
| 178 | +- [Install standalone skills](/guides/skills) |
| 179 | +- [Plugin release checklist](/contributing/agent-plugins) |
0 commit comments