Agent Motion CLI commands and Codex plugin
Use the machine-readable CLI from Codex, Claude Code, Cursor, or any terminal-capable coding agent.
Project commands
npx @agent-motion/cli create remotion <directory>creates a structured Remotion project.npx @agent-motion/cli doctor --cwd <project> --jsonchecks project compatibility.
Discovery and planning
list --jsonreturns the full catalog.search "<visual intent>" --jsonranks components with evidence.suggest <beat> --intent "<scene context>" --jsonproposes visual treatments.info <name> --jsonreturns the complete component contract.
Install editable source
Preview with add <name>@<version> --cwd <project> --dry-run --json, then run the same command without --dry-run.
Screenshot to editable scene
scene from-image <image> --name <scene-name> --cwd <project> --json reconstructs a product UI screenshot as addressable Remotion layers. The CLI reads OPENAI_API_KEY from the target project’s .env.local or the process environment. Agents should run the dry-run first and never request, print, or pass the key as a CLI argument. The calling agent still controls animation timing.
Shared options
--cwd points to the target Remotion project. Omit it when running from the project root. Use --json for stable machine-readable output.