{"record":{"id":"08aeefcfabea67e8","repo":"remotion-dev/remotion","slug":"no-lambda-cli-help-metadata-exists-for-flag","errorCode":null,"errorMessage":"No Lambda CLI help metadata exists for --${flag}","messagePattern":"No Lambda CLI help metadata exists for --(.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/lambda/src/cli/help.ts","lineNumber":168,"sourceCode":"\t},\n\tquiet: {flag: '--quiet, -q', description: 'Reduce console output.'},\n};\n\nconst options = (\n\tflags: readonly string[],\n\tdescriptionOverrides: Record<string, string> = {},\n): HelpOption[] => {\n\treturn flags.map((flag) => {\n\t\tconst lambdaOption = lambdaOptions[flag];\n\t\tif (lambdaOption) {\n\t\t\treturn lambdaOption;\n\t\t}\n\n\t\tconst rendererOption = rendererOptions.find(\n\t\t\t(candidate) => candidate.cliFlag === flag,\n\t\t);\n\t\tif (!rendererOption) {\n\t\t\tthrow new Error(`No Lambda CLI help metadata exists for --${flag}`);\n\t\t}\n\n\t\treturn CliInternals.makeCommandHelpOption({\n\t\t\toption: rendererOption,\n\t\t\tdescription: descriptionOverrides[flag],\n\t\t});\n\t});\n};\n\nconst commandHelp = [\n\t{\n\t\tpath: [],\n\t\targs: ' <command>',\n\t\tdescription: 'Control Remotion Lambda.',\n\t\tdocumentation: 'https://www.remotion.dev/docs/lambda/cli',\n\t\toptions: [],\n\t},\n\t{","sourceCodeStart":150,"sourceCodeEnd":186,"githubUrl":"https://github.com/remotion-dev/remotion/blob/b2f4e34732f3c6c222ea029413e22dc402218cd7/packages/lambda/src/cli/help.ts#L150-L186","documentation":"The Lambda CLI help generator maps renderer options (from @remotion/renderer metadata) onto Lambda-specific help output. When a flag listed as needing a help entry has no matching renderer option with that cliFlag, this invariant error is thrown. It indicates the Lambda package and renderer package metadata are out of sync — a library bug, not a user error.","triggerScenarios":"Running a Lambda CLI command's help (or options resolution) where the internal rendererOptions list has been filtered or is missing a candidate whose cliFlag equals the requested flag — e.g. after a Remotion version mismatch where CLI code expects a newer flag than the metadata provides.","commonSituations":"Mixed @remotion/* package versions in node_modules after a partial upgrade, a typo'd or renamed flag passed into an internal descriptionOverrides map, or custom tooling calling CliInternals.options() with an unknown flag.","solutions":["Ensure all @remotion/* packages are on the same version (npx remotion upgrade, or check node_modules for mismatched versions).","Delete node_modules and lockfile, reinstall, and rebuild so Lambda and renderer metadata match.","Check the flag name for typos; only flags defined in @remotion/renderer's option metadata are supported.","If triggered by custom code, register the flag in rendererOptions or remove it from descriptionOverrides. This is otherwise a Remotion bug — file an issue."],"exampleFix":"// before (mismatched versions)\n\"@remotion/lambda\": \"4.0.220\",\n\"@remotion/renderer\": \"4.0.236\"\n// after\n\"@remotion/lambda\": \"4.0.236\",\n\"@remotion/renderer\": \"4.0.236\"","handlingStrategy":"validation","validationCode":"const flagToCheck = 'concurrency';\nif (!rendererOptions.some((o) => o.cliFlag === flagToCheck)) {\n  console.warn(`Flag --${flagToCheck} has no Lambda help metadata`);\n}","typeGuard":"function hasHelpMetadata(flag: string): boolean {\n  return rendererOptions.some((o) => o.cliFlag === flag);\n}","tryCatchPattern":null,"preventionTips":["Keep all @remotion/* packages on the same version","After upgrading, reinstall node_modules cleanly to sync internal metadata","Never pass ad-hoc flags into internal CliInternals help APIs","Only reference flags documented in @remotion/renderer option metadata"],"tags":["cli","lambda","help-metadata","version-mismatch"],"backgroundTag":"missing-required-option","analyzedSha":"b2f4e34732f3c6c222ea029413e22dc402218cd7","analyzedAt":"2026-09-09T13:27:51.281Z","contentChangedAt":"2026-09-09T13:27:51.281Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}