Skip to main content
Smart Video supports macOS and Windows. Install it in the Codex desktop app on the computer where you want to create and render videos.

​
Install from Plugins

1

Open Plugins

Open Plugins from the Codex desktop app sidebar.
2

Add a marketplace

Select Create, then Add marketplace.
3

Add the JoggAI repository

Paste the following Git repository URL and confirm:
4

Install Smart Video

Open the Personal tab, find Smart Video, and select Install.
The plugin source is available at JoggAI-Tech/jogg-skills/plugins/smart-video. After installation, start a new conversation so Codex loads the plugin. Try:

​
Install from the bundled Codex CLI

You can also install from a terminal with the Codex CLI bundled with the desktop app:
Use the Codex CLI that belongs to your desktop app installation. A separate CLI installation may use a different plugin directory and will not make the plugin available in the desktop app.

​
First-run setup

The first Smart Video request checks the local environment before starting the Studio:
  1. doctor reports missing requirements without changing your computer.
  2. bootstrap installs and verifies the pinned SmartVideo runtime when required.
  3. preflight starts the local service and checks both the health and Settings pages.
  4. Codex shows the Settings URL only after the service is ready.
Approve the bootstrap step when Codex asks to install missing dependencies. Normal video commands do not install software.

​
Platform requirements

On macOS, Smart Video installs pinned Node.js and FFmpeg builds under its managed user directory and verifies their checksums. It does not use Homebrew for either tool. Bootstrap may still offer Homebrew for other missing host tools such as Python, jq, or Chrome. Smart Video keeps managed dependencies outside the plugin directory under your Codex user data. Plugin updates do not remove existing projects or JoggAI authorization.
You do not need to configure a source checkout, renderer path, npm package path, or project directory. Smart Video creates a new workspace for each video unless you explicitly ask to reuse one.