# add-cli-option

> Claude/Codex skill by [@remotion-dev](https://omgskills.com/library/remotion-dev/index.md) · 66k stars · Updated 2026-10-22

Add a new Remotion CLI or config option by creating an AnyRemotionOption, registering CLI parsing, wiring config setters, and updating documentation. Use when adding or converting command-line flags or Remotion options.

Tags: javascript, react, video

## Install

```sh
git clone https://github.com/remotion-dev/remotion /tmp/remotion && ln -s /tmp/remotion/.agents/skills/add-cli-option ~/.claude/skills/add-cli-option
```

## From README

Add a new CLI option How to convert a hardcoded CLI flag into a proper AnyRemotionOption, or add a brand new one. Create the option definition Create packages/renderer/src/options/ .tsx: The type in AnyRemotionOption and type: as T determines the option's value type. Use boolean, string | null, number | null, etc. The id must be unique and contain only lowercase letters, digits, and hyphens. It determines the /docs/options/ page and the value. It usually matches cliFlag, but shared flags can have distinct option IDs. Set docLink to https://www.remotion.dev/docs/options/ . For negating flags (like --disable-ask-ai → askAIEnabled = false), handle the inversion in getValue. Register in options index packages/renderer/src/options/index.tsx: Add the import (keep alphabetical within the import block) Add the option to the allOptions object This makes it available as BrowserSafeApis.options.myFlagOption throughout the codebase.

## Links

- HTML page: https://omgskills.com/skills/remotion-dev/remotion/add-cli-option/
- GitHub: https://github.com/remotion-dev/remotion
- Author: [@remotion-dev](https://omgskills.com/library/remotion-dev/index.md)

## More from this repo

- [pr-name](https://omgskills.com/skills/remotion-dev/remotion/pr-name/index.md) — Used to review or correct a Remotion pull request title
   - [@remotion-dev](https://omgskills.com/library/remotion-dev/index.md) · 66k stars
- [add-effect](https://omgskills.com/skills/remotion-dev/remotion/add-effect/index.md) — Used to add a new effect to @remotion/effects, including implementation, package exports, docs, demos, preview images,...
   - [@remotion-dev](https://omgskills.com/library/remotion-dev/index.md) · 66k stars
- [add-new-package](https://omgskills.com/skills/remotion-dev/remotion/add-new-package/index.md) — Used to add a new package to the Remotion monorepo, including package scaffolding, monorepo registration,...
   - [@remotion-dev](https://omgskills.com/library/remotion-dev/index.md) · 66k stars