# Agent Motion

> Open-source registry of production-ready Remotion components with editable TypeScript source and machine-readable manifests.

Agent Motion helps developers and coding agents discover, preview, inspect, and install composable video components. No account or API key is required.

## Main pages

- [Component registry](https://agent-motion.com/registry): Browse all components and live previews.
- [For coding agents](https://agent-motion.com/agents): Safe CLI and HTTP workflow.
- [Discovery manifest](https://agent-motion.com/.well-known/agent-motion.json): Machine-readable service capabilities and endpoints.
- [Registry JSON](https://agent-motion.com/registry/index.json): Machine-readable catalog.

## Recommended agent workflow

Install the reusable Codex skill once:

```bash
codex plugin marketplace add https://gitlab.com/VRymarovich/agent-motion-plugin.git
codex plugin add agent-motion@agent-motion
```

Then invoke `$agent-motion`, or use the CLI directly:

1. Inspect the target project: `npx @agent-motion/cli doctor --json`
2. Discover components: `npx @agent-motion/cli list --json` or `npx @agent-motion/cli search <intent> --json`
3. Inspect a contract: `npx @agent-motion/cli info <name> --json`
4. Start from `exampleProps` and obey enum, range, length, and `sameLengthAs` constraints.
5. Preview a pinned install: `npx @agent-motion/cli add <name>@<version> --dry-run --json`
6. Install editable source: `npx @agent-motion/cli add <name>@<version>`

## Components

- [Animated Counter](https://agent-motion.com/components/animated-counter): A bold metric counter with a spring entrance and contextual trend chip.
- [Bar Chart](https://agent-motion.com/components/bar-chart): An editorial animated bar chart for ranked metrics and categorical comparisons.
- [Browser Spotlight](https://agent-motion.com/components/browser-spotlight): A polished Chrome or Safari frame that accepts any React content as the page body.
- [Chat Conversation](https://agent-motion.com/components/chat-conversation): A polished message thread for testimonials, product stories, and conversational explainers.
- [Comparison Table](https://agent-motion.com/components/comparison-table): A high-contrast feature comparison for products, plans, and before-versus-after stories.
- [Feature List](https://agent-motion.com/components/feature-list): A bold split-layout scene for product benefits, capabilities, and numbered talking points.
- [Logo Reveal](https://agent-motion.com/components/logo-reveal): A geometric brand reveal for intros, outros, sponsorships, and identity transitions.
- [Product Timeline](https://agent-motion.com/components/product-timeline): A sequential milestone track for workflows, roadmaps, and multi-step product stories.
- [Progress Ring](https://agent-motion.com/components/progress-ring): A focused circular progress indicator for percentages, scores, and completion states.
- [Signal Chart](https://agent-motion.com/components/signal-chart): A cinematic line chart for growth stories, launches, and time-series highlights.

## Direct HTTP access

- Component manifest: https://agent-motion.com/registry/<name>/manifest.json
- Component file: https://agent-motion.com/registry/<name>/<filename>

## Safety

- Start from each manifest's render-safe `exampleProps` and obey all prop constraints.
- Check compatibility, timing, formats, dependencies, and agentHints before installation.
- On failure, branch on `error.code`, follow `error.action`, and retry automatically only when `error.retryable` is true.
- Do not use `--force` or `--install-deps` without explicit user approval.
- Successful installs are tracked in `.agent-motion/lock.json` with SHA-256 integrity digests.
- All public registry resources are readable without authentication.